XHCDNS 使用教程

#1. 注册账号

XHCDNS 采用用户名 + 邮箱 + 密码体系，注册后需验证邮箱才能使用全部功能。

1. 打开 控制台 /app，点击右上角「登录 / 注册」。
2. 切换到「注册」选项卡，填写 用户名、邮箱、密码，提交。
3. 系统会向你的邮箱发送一封验证邮件，点击邮件中的链接完成验证。
4. 验证通过后即可登录，默认获得 3 个免费子域名名额。

#2. 申请子域名

在 xhcdns.com 根域下申请你喜欢的二级前缀，系统自动检测可用性。

1. 进入控制台「注册子域名」页（或首页点击「立即免费注册」）。
2. 在输入框填写心仪前缀，例如 myblog、game、api。
3. 点击「检测可用性」，绿色表示可注册。
4. 确认后点击「申请」，子域名 前缀.xhcdns.com 立即生效。

#3. DNS 记录管理

在控制台「我的域名」中点击某个子域名，进入其 DNS 记录管理面板，支持 8 种记录类型。

添加一条记录

1. 在记录面板点击「添加记录」。
2. 选择类型，填写名称（留空表示根，即该子域名本身）与内容。
3. 设置 TTL（默认 3600 秒）与 优先级（MX / SRV 需要）。
4. 保存后，Cloudflare 会实时同步，通常几分钟内全球生效。

#4. NS 委托（接入你自己的解析服务）

如果你希望由 Cloudflare / DNSPod / 阿里云等第三方全权解析某个子域名（以享受其 CDN、WAF 与免费 SSL），可使用 NS 委托。下面以最常用的 Cloudflare 为例，给出从 0 到 HTTPS 的完整步骤。

4.1 先判断：你到底需不需要 NS 委托？

4.2 实操：把子域名完整托管到 Cloudflare（方式二）

1. 注册并登录 Cloudflare 账号（免费版即可）。
2. 点击「Add a Site」→ 输入你的完整子域名（例如 blog.xhcdns.com）→ 选 Free 套餐 → 点「Add Site」。
3. Cloudflare 扫描现有记录后进入下一步，会给出两组 NS 服务器，类似：

   ns1.cloudflare.com
   ns2.cloudflare.com

   把这两行记下来（你的实际值以页面显示为准，通常是 xxx.ns.cloudflare.com 形式）。此时先不要在 Cloudflare 点任何「完成 / 去改 NS」的按钮。
4. 回到 XHCDNS 控制台 → 「我的域名」→ 点进该子域名 → 切到「NS 委托」选项卡。
5. 把第 3 步拿到的两条 NS 分别填入两个输入框，点击「保存委托」。平台会立刻在 xhcdns.com 权威区写入 NS 记录，把解析权交出去。
6. 回到 Cloudflare。因为 xhcdns.com 的「注册商」就是 XHCDNS 本身，上一步保存即等于完成了 NS 变更。Cloudflare 检测到 NS 生效后，会把站点状态变为 Active（绿色对勾）；若仍显示 Pending，等几分钟刷新即可。
7. 状态 Active 后，在 Cloudflare 的 DNS 页添加真实记录：A 指向你的服务器公网 IP，或 CNAME 指向源站域名。
8. 在 Cloudflare 的 SSL/TLS 页把模式设为 Full 或 Full (strict)；默认开启的橙色云 ☁️（Proxied）即为启用 CDN。此时访问 https://blog.xhcdns.com 已是 HTTPS + 加速。

4.3 验证委托是否生效

保存委托后，用以下命令确认该子域名的 NS 是否已指向 Cloudflare（把 blog 换成你的前缀）：

# Windows (PowerShell / CMD)
nslookup -type=NS blog.xhcdns.com

# macOS / Linux
dig +short NS blog.xhcdns.com
# 期望看到：ns1.cloudflare.com.  ns2.cloudflare.com.

4.4 使用 DNSPod / 阿里云等其他服务商

流程完全一致：在对方后台添加站点拿到 NS → 回到 XHCDNS「NS 委托」填那两组 NS → 保存。之后所有记录都在对方后台配。注意对方若不提供 CDN / SSL，需自行处理证书。

#5. 续期与有效期

免费子域名默认有效期 365 天，到期前可在控制台一键续期。

1. 进入「我的域名」，找到即将到期的子域名。
2. 点击「续期」按钮，有效期再延长 365 天。
3. 建议在到期前 30 天内完成续期，避免解析中断。

#6. 邀请扩容

默认 3 个名额不够用？通过推荐链接邀请好友，每成功注册 1 位即 +1 名额，最高 10 个。

1. 进入控制台「推荐扩容」页，复制你的专属推荐链接。
2. 分享给朋友，对方通过该链接注册并验证邮箱后，你的名额 +1。
3. 名额实时更新，可在「我的域名」页顶部查看当前已用 / 总额度。

#7. REST API

平台提供 Bearer Token 鉴权的开放 API，可在脚本、CI/CD 中自动化管理域名与记录。

① 获取 Token

进入控制台「API Token」页，生成一个 Token（仅展示一次，请妥善保存）。

② 调用示例

# 列出我的子域名
curl -H "Authorization: Bearer <YOUR_TOKEN>" \
     https://xhcdns.com/api/domains

# 添加一条 A 记录
curl -X POST -H "Authorization: Bearer <YOUR_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{"subdomain":"myblog","type":"A","name":"","content":"1.2.3.4","ttl":3600}' \
     https://xhcdns.com/api/domains/myblog/records

#8. 常见问题