自定义订阅域名迁移指南：DNS 配置、自动 HTTPS 与常见问题

如果你以前在 Nodebuf 绑定过自己的订阅域名，这次需要重新确认域名归属，并把解析改到新的订阅入口。迁移完成后，仍然可以使用自己的域名获取订阅，不需要重新创建动态订阅或上传文件。

新版 Nodebuf 已使用正式域名 nodebuf.com。请按本文完成自定义域名迁移：打开自定义域名管理。原账号、文件和动态订阅地址继续保留。

本文不会要求你提供 Cloudflare API Token、域名账号密码或服务器密码。准备好能够修改 DNS 的域名，按页面配置两条记录即可。

先看这次需要改什么

新版使用专门的订阅入口 ingress.nodebuf.com。你自己的域名通过 CNAME 指向这个入口，再通过一条 TXT 记录证明域名归你所有。验证通过后，Nodebuf 自动申请并维护 HTTPS 证书。

旧版的“已验证”表示以前的接入结果，不能代替这次验证。因此，即使列表里已经有你的域名，也请进入这个域名的卡片，按新版记录完成一次验证。不要为了迁移先删除已有域名，也不要先删除订阅或文件。

如果旧域名正在使用，修改它的 DNS 可能存在解析缓存和证书准备的过渡期。希望先试好再切换的话，可以先用一个新的子域名完成全部步骤，再更新客户端地址。

第一步：打开自己的域名记录

1. 在 Nodebuf 网站 登录你的账号。
2. 打开“用户空间 → 连接与文件 → 自定义域名”，或者直接访问 自定义域名管理。
3. 找到已有域名，展开或查看它的 DNS 配置。如果还没有记录，添加你准备使用的子域名，例如 sub.example.com。
4. 保持页面打开，后面需要复制页面给出的 CNAME 和 TXT 内容。

这里只填写域名，例如 sub.example.com，不要填写 https://、端口、/dynamic 或整条订阅链接。每个账号目前最多可以管理 10 个域名。

建议使用专门的子域名，例如 sub.example.com、subscribe.example.com。直接使用根域名 example.com 容易和网站、邮箱等配置产生冲突；部分 DNS 服务还会把根域名 CNAME 展平，导致系统无法核对实际 CNAME。先使用普通子域名更容易配置。

第二步：在 DNS 后台配置两条记录

下面以你管理的域名 example.com、准备使用的订阅域名 sub.example.com 为例。请在域名的 DNS 解析后台操作；如果域名的 NS 已交给 Cloudflare，就去 Cloudflare 修改，不能只在原注册商添加记录。

TXT 值每个域名都有自己的内容，必须从你自己的管理页面复制。本文没有提供可以直接使用的验证值。 不要复制其他用户的截图，也不要把“从页面复制”几个字填进 DNS 后台。

DNS 后台只让填写“主机记录”怎么办

很多服务商会自动补上当前区域的根域名。你正在管理 example.com 时，一般这样填写：

• CNAME 的主机记录填 sub，目标填 ingress.nodebuf.com。
• TXT 的主机记录填 _nodebuf.sub，内容粘贴 Nodebuf 显示的完整值。

如果准备使用的是 my.sub.example.com，通常分别填 my.sub 和 _nodebuf.my.sub。有些服务商接受完整域名，有些只接受相对名称，保存后请核对它实际显示的完整记录名，避免变成 sub.example.com.example.com。

手机端操作时，记录名称、记录值和代理状态可能需要横向滑动或展开更多选项才能看到。建议每保存一条就回到记录列表检查一次。

使用 Cloudflare 的用户特别留意

请把这条订阅子域名的云朵设置成灰色，页面文字应为“仅 DNS”。主站或其他子域名的橙云配置可以继续保留。

新版会核对 CNAME 及最终公网解析。开启橙云、使用其他 CDN 或把域名指向另外一层不受支持的代理，可能导致验证失败。这里不需要创建 Cloudflare 自定义主机名，不需要配置 Tunnel，也不需要把 Cloudflare API Token 交给 Nodebuf。

如果 sub.example.com 已经有 A、AAAA 或旧 CNAME，请先记录旧值，再将同一个主机名的冲突记录改成上面的 CNAME。不要删除根域名、邮箱或其他子域名的记录。TXT 位于另一个名字 _nodebuf.sub.example.com，不会占用 sub.example.com 的 CNAME。

TTL 可以使用 DNS 服务商的默认值或“自动”。迁移时不建议反复改来改去，以免更难判断缓存是否已经更新。

第三步：回到 Nodebuf 验证，并等待 HTTPS 就绪

保存两条 DNS 记录后，回到域名管理页面，点击这个域名的验证按钮。

系统会确认域名归属和入口解析。通过后，证书服务会自动为你的域名准备 HTTPS。“域名已验证”与“HTTPS 已就绪”是两个阶段；请等到页面明确显示可以使用，再复制到客户端。 可以使用页面的刷新按钮查看最新状态。

DNS 生效时间与原来的 TTL、服务商和各地缓存有关；证书签发还需要外部验证，无法保证点击后立刻完成。页面还在准备中时，先保留这两条 DNS 记录，稍后刷新即可。不要通过关闭客户端的证书校验来绕过等待。

这一步由 Nodebuf 的订阅入口接收公网 HTTP 验证并提供 HTTPS 访问，你不需要另买服务器、开放家里路由器端口，也不需要自己安装证书。入口的 80 端口用于 HTTP-01 验证，443 端口用于 HTTPS；不要在 DNS 前再加一个阻断这些访问的代理。HTTP-01 的端口要求见 Let’s Encrypt 官方说明。

验证成功后也请长期保留 CNAME 和 TXT。Nodebuf 会继续检查解析与归属，并自动维护证书；以后把域名指向其他地方、删除 TXT 或移除账号中的域名，都会影响这条专属入口的使用。

第四步：取得完整订阅链接，再导入客户端

等域名与 HTTPS 都准备好后，打开你要使用的动态订阅、文件或站内短链接，在链接窗口里选择自己的自定义域名，再复制生成的完整地址。

自定义域名替换的是链接前面的站点部分。例如，下面只是结构示意，你的路径、你的密钥不是真实参数：

原地址：https://nodebuf.com/dynamic?path=你的路径&security=你的密钥&type=clash
新地址：https://sub.example.com/dynamic?path=你的路径&security=你的密钥&type=clash

/dynamic 后面的路径与查询参数需要完整保留，特别是 path、security、type。静态文件的文件 ID、访问 Token，仓库订阅的签名，以及站内短链接的代码，也都不能随意删改。

迁移不会自动改掉客户端已经保存的地址。如果你仍使用同一个自定义域名，先在客户端更新订阅并核对内容；如果换了一个新域名，就把客户端中的旧订阅地址替换为新地址。不要只把地址改成域名首页。

建议先在一个客户端验证：可以拉取订阅、节点数量合理、格式符合客户端要求，再更新其他设备。主站原有链接仍然保留，自定义域名是额外入口；请妥善保存自己的完整原链接。

哪些链接可以使用自己的域名

自定义域名只服务于这个域名所属账号自己的资源，不是给整个 Nodebuf 网站换域名。

如果直接打开 https://sub.example.com/，看到“该域名仅用于订阅访问”之类的提示，这是访问范围说明，不代表订阅一定故障。请使用带完整路径和参数的真实订阅链接。登录、修改订阅和管理文件，仍然在 Nodebuf 主站操作。

自定义域名不会取消订阅密钥、文件 Token、设备限制或账号权限。完整订阅地址仍可能包含访问凭据，请只交给自己的客户端和可信的人；不要把它发到公开评论或求助截图里。

遇到问题时，先按这个顺序检查

提示没有找到 TXT，或域名归属验证失败

先确认 TXT 的完整名字是 _nodebuf.你的订阅域名。例如 sub.example.com 对应 _nodebuf.sub.example.com，不是 _nodebuf.example.com。

然后检查内容是否从当前账号、当前域名的页面完整复制，是否多了空格、换行或手动添加的引号。DNS 控制台可能会自动用引号显示 TXT，通常不需要把显示用的引号再次输入。如果刚保存，等待解析缓存更新后再验证。

提示 CNAME 不匹配，或没有指向入口

检查目标是否为 ingress.nodebuf.com，不要填写 https://ingress.nodebuf.com，也不要继续指向旧入口或主站域名。Cloudflare 的这条记录必须是灰云。

还要检查同名 A、AAAA、旧 CNAME 或服务商的线路记录，避免部分地区仍解析到旧地址。不要为了省略一步改填服务器 IP：按管理页面提供的 CNAME 配置，后续入口调整时才不需要你逐个修改 IP。

域名验证通过，但 HTTPS 一直没有准备好

先稍等并刷新状态，确认 DNS 没有再次被改动。如果一直失败，检查域名是否被其他 CDN、转发服务或安全策略接管，导致证书验证请求到不了 Nodebuf 入口。

如果域名配置了 CAA 签发限制，或者 DNSSEC、权威 DNS 响应异常，也可能妨碍证书申请。请保留现有安全设置，联系域名服务商或 Nodebuf 支持确认具体原因；需要允许 Let’s Encrypt 时，其 CAA 标识为 letsencrypt.org。不要直接在已有 CNAME 的同一个记录名下再加 CAA，也不要为了排查删除所有 CAA。 CAA 的查找还会涉及 CNAME 目标，应按实际解析链检查。CAA 的继承、CNAME 与错误说明见官方文档。

求助时可以提供自定义域名、页面状态和大致操作时间。不要发送订阅密钥、完整文件 Token、账号密码或 DNS API Token。

浏览器提示证书不匹配，或客户端更新失败

确认域名页面已经显示 HTTPS 就绪，使用的是 https://，域名拼写正确，地址中没有多余端口。刚迁移时，设备或网络可能还缓存旧解析；稍后重试，或换一个网络检查。不要忽略证书警告，也不要关闭 TLS 校验。

如果 HTTPS 正常但提示无权访问，检查链接是不是本人账号的资源，路径和全部查询参数有没有保留，以及域名是否仍绑定在同一个账号。访问域名首页收到范围提示，与访问订阅失败是两种情况。

改 DNS 以后，旧链接还能不能使用

Nodebuf 主站原地址不会因为你配置自定义域名而被删除。旧自定义域名能否立即切换，取决于 DNS 缓存、新入口验证和 HTTPS 状态，因此请先验证新入口再安排客户端更新。主站已切换新版，但你自己的域名仍需完成 DNS、归属验证和 HTTPS 检查；旧 VERIFIED 状态不会自动代表新入口已就绪。

迁移完成前，核对这张清单

• 已在自己的 Nodebuf 账号里找到或添加正确域名，没有删除原订阅、文件。
• CNAME 指向 ingress.nodebuf.com，Cloudflare 为灰云，没有同名冲突记录。
• _nodebuf TXT 的完整名称和内容与管理页面一致。
• 域名验证已通过，HTTPS 已明确显示就绪。
• 使用完整订阅链接测试成功，路径、密钥、Token 和短链接代码都保留。
• 客户端已经更新；其他设备也使用了需要的新地址。
• CNAME、TXT 保持不动，后续证书交给系统维护。

最后说明一下新的接入边界：DNS 直连方式不需要占用 Cloudflare 自定义主机名配额，但“仅 DNS”本来就会公开解析到的入口 IP，不能把它理解成隐藏服务器的功能。你需要维护的只有自己的 DNS 记录与订阅链接；主站防护、入口服务和证书维护由 Nodebuf 负责。