XHCDNS DOCS

快速开始、子域名、DNS 记录、NS 委托、REST API 与账号安全——所有你需要知道的，一站查清。

1 快速开始 2 子域名 3 DNS 记录 4 NS 委托 5 配额与续期 6 REST API 7 工具 8 账号安全 9 支持

#1. 快速开始

  1. 注册账号（用户名 + 邮箱 + 密码），完成后自动登录。
  2. 查收邮箱验证邮件并点击链接（未验证部分功能受限）。
  3. 新用户首次登录需绑定 GitHub 账号。
  4. 登录采用「密码 + 邮箱验证码」两步验证，5 分钟内有效。
  5. 进入控制台，默认获得 3 个免费子域名名额。
提示：忘记密码可在登录页使用「找回密码」；密码 pbkdf2 强哈希存储。

#2. 子域名

  1. 在「注册子域名」页选择根域（xhcdns.com / xhcns.org / nekos.uk）并填写前缀。
  2. 命名规则：字母/数字/连字符，3–63 字符，无连续连字符。
  3. 点击「检查可用性」，绿色即可申请，注册即生效。
  4. 不用了可在域名详情页删除，名额即时释放。

#3. DNS 记录

  1. 支持 A / AAAA / CNAME / MX / TXT / NS / SRV / CAA 共 8 种，含 TTL 与优先级。
  2. 域名详情页「添加记录」→ 保存，Cloudflare 权威 DNS 自动写回。
  3. 记录行「编辑 / 删除」随时修改。
  4. 「导出 DNS」一键复制 BIND zone 配置，便于备份与迁移。
  5. TTL 越小生效越快；稳定后可调大以减少查询压力。

#4. NS 委托

  1. 想用 Cloudflare 的 CDN / SSL / WAF？把子域名 NS 委托给第三方解析。
  2. 在 Cloudflare「Add a Site」添加完整子域名，拿到两组 NS。
  3. 回 XHCDNS 域名详情「NS 委托」填入并保存，解析权即移交。
  4. 委托后记录在被委托方管理；「取消委托」可收回解析权。

#5. 配额与续期

  1. 默认 3 个名额；「推荐扩容」每邀请 1 人 +1，最高 10 个。
  2. 管理员发放的兑换码可在推荐页兑换，直接增加名额。
  3. 子域名默认 365 天；到期前 30 天内可一键续期，永久免费。

#6. REST API

Bearer Token 鉴权（请求头 Authorization: Bearer <token>）；完整端点见控制台「API 文档」页。
MethodEndpoint
GET/api/domains
POST/api/domains
GET/api/domains/{id}
PUT/api/records/{rid}
GET/api/dns/lookup?domain=
GET/api/whois?domain=

#7. 工具

  1. DNS 查询：查任意域名 A / AAAA / CNAME / NS 解析（系统 nslookup）。
  2. WHOIS（RDAP）：查注册局级域名的注册 / 过期 / 注册商 / NS 信息（子域名无独立记录）。

#8. 账号安全

  1. 密码 pbkdf2 强哈希，平台不存明文。
  2. 登录强制「密码 + 邮箱验证码」两步验证（2FA）。
  3. API Token 独立于登录密码，支持权限范围限定。
  4. 「账号」页可修改密码与全名；建议绑定 GitHub 便于找回。

#9. 支持

  1. 常见问题（FAQ） · 详细教程
  2. 邮件联系：[email protected]
  3. 开源代码：GitHub · SanhanaYuzu