更新时间:2026 年 10 月 30 日。这篇指南适用于已经添加域名的用户,也适用于第一次接入。现在自定义域名统一通过 Cloudflare for SaaS 接入,CNAME 目标改为 nodebuf.com。此前使用 ingress.nodebuf.com 的用户,请按下面步骤迁移。
先保留一份主站订阅链接
开始前,在 动态订阅管理、我的文件 或 订阅短链接 复制一份使用 nodebuf.com 的完整链接。链接中的路径、访问密钥和其它参数都要保留。
切换 DNS 到 Cloudflare 证书就绪之间可能出现短暂不可用。保留主站链接,可以在这段时间正常更新订阅。不要先删除已有域名再重新添加;已有域名直接修改 DNS、回到原记录重新验证即可,原域名记录、订阅和文件不需要重建。
这次更改了什么
| 项目 | 现在的方式 |
|---|---|
| 用户域名的 CNAME 目标 | nodebuf.com |
| Cloudflare DNS 面板中这条用户记录的代理状态 | 推荐已代理 / 橙云(O2O);灰云也支持 |
| 域名归属证明 | 保留本人页面显示的 _nodebuf TXT |
| Cloudflare 额外验证 | 页面有列出时,补充相应 TXT |
| HTTPS 证书 | Cloudflare 签发、部署和续期 |
| 已有订阅、静态文件、访问密钥 | 保留,不需要重新生成 |
如果你的域名也托管在 Cloudflare,推荐为这条 CNAME 开启“已代理 / 橙云”,通过 O2O 接入。O2O 要求你的域名与 Nodebuf 位于不同 Cloudflare 账号;同一账号的域名可使用灰云。其他 DNS 服务商继续使用普通 CNAME 即可。灰云仍受支持,已经按灰云配置并正常使用的用户不必为了这次升级删除或重建记录。你不需要提供 Cloudflare API Token,也不需要自己调用 API。
Cloudflare 代理可以减少直接暴露订阅入口 IP,但不能保证所有网络都能访问,也不能承诺避免所有域名限制。
第一步:打开已有域名,或添加新域名
登录 自定义域名,位置是「用户空间 → 连接与文件 → 自定义域名」。
- 已经有域名:在列表中点选原记录,直接看它的 DNS 配置。
- 第一次使用:点“添加域名”,只填写域名,例如
sub.example.com,不要填写https://、端口或路径。 - 域名目前属于其他账号:先核实账号和归属,不要重复添加或复制其他人的验证值。
系统会显示这个域名专属的记录。下文的 example.com 和验证值只是说明;真正配置时,请复制你自己页面上的内容。
第二步:修改 DNS 记录
使用二级域名,推荐从这里开始
假设你拥有 example.com,希望使用 sub.example.com:
| 类型 | 完整名称 | 记录值 | 代理状态 |
|---|---|---|---|
| CNAME | sub.example.com |
nodebuf.com |
Cloudflare 推荐橙云,灰云也可 |
| TXT | _nodebuf.sub.example.com |
复制本人页面的完整值 | 仅 DNS |
很多 DNS 服务商会自动补上根域名,所以在 example.com 的记录页,主机记录通常填 sub 和 _nodebuf.sub。如果填写完整域名后,面板预览变成了 sub.example.com.example.com,就说明重复追加了根域名,要改成相对名称。
2026 年 10 月 30 日补充:之前通知中要求统一使用灰云,是当时程序的兼容限制。现在橙云与灰云都支持,Cloudflare 用户推荐橙云。
CNAME 的值只有 nodebuf.com,不带 https://,也不带 /。删除或修改同名冲突的 A、AAAA、CNAME 记录,避免用户域名同时指向不同服务。不要手工复制某次查询得到的 Cloudflare IP 来替代 CNAME。
旧域名原来指向 ingress.nodebuf.com 时,只修改原 CNAME 的目标即可;已有正确 _nodebuf TXT 保持不变。不要把 TXT 中的引号、空格或部分内容误当成验证值,是否需要引号以 DNS 面板的输入规则为准。
使用根域名
根域名 example.com 也可以接入,前提是 DNS 服务商支持根域名 CNAME 展平、ALIAS 或等效功能。例如 Cloudflare 的根域名 CNAME:
| 类型 | 主机记录 | 完整名称 | 记录值 |
|---|---|---|---|
| CNAME | @ |
example.com |
nodebuf.com,Cloudflare 推荐橙云(O2O),灰云也可 |
| TXT | _nodebuf |
_nodebuf.example.com |
复制本人页面的完整值 |
根域名查询时可能只返回 A/AAAA,而不直接返回 CNAME,这是正常的展平行为。Nodebuf 会同时核对本人的 TXT 和解析地址。若服务商不支持展平,建议先使用 sub.example.com,不要随意添加一条 A 记录碰碰运气。
根域名原先用于网站时,改变它的 CNAME 也会影响原网站。只希望订阅使用新域名的话,单独使用一个二级域名更合适。Cloudflare CNAME 展平说明。
第三步:验证 DNS 与 HTTPS
保存 DNS 后,回到原域名记录,点击“验证 DNS 与 HTTPS”或“重新验证”。页面会检查:
_nodebufTXT 是否为当前账号这条记录的验证值。- CNAME 或根域名展平结果是否指向当前接入目标。
- Cloudflare 是否完成域名验证。
- HTTPS 证书是否签发并部署完成。
如果页面列出额外 TXT,例如 _cf-custom-hostname 或 _acme-challenge 开头的记录,请按实际显示的完整名称和值补上。不要照抄别人截图中的值。补好后稍等解析生效,再次验证。
Cloudflare 域名状态和 SSL 状态都为 active,并且当前 DNS 校验通过后,才表示可以使用。 添加成功、DNS 保存成功,或仅有域名状态 active,都不等于 HTTPS 已准备好。
等待签发时不需要反复删除重建。稍后重新验证即可。旧记录如果曾被标记 moved、deleted 或验证超时,系统会在当前 DNS 通过后尝试重新验证;若提示需管理员检查,请通过站内私信联系我们,提供域名和错误代码即可,不要公开订阅密钥。
第四步:复制完整链接并导入客户端
域名显示可使用后,回到动态订阅、文件或站内短链接页面,选择这个自定义域名,再复制完整地址。不要只把 https://sub.example.com 导入客户端;它缺少订阅路径和访问参数。
如果手动替换域名,只替换链接的主机部分,其余路径、查询参数和密钥都保持原样。客户端仍使用旧缓存时,请主动更新一次订阅。旧主站链接继续有效,不需要修改节点、转换模板或文件内容。
自定义域名可以访问哪些内容
可以访问这个域名所属账号的动态订阅、静态文件下载、仓库转发链接和站内短链接。已经支持的网站面板订阅也沿用原有权限检查。
自定义域名不是主站镜像。直接打开根地址、工具页、登录页或管理后台时,会看到受限访问提示;这不代表订阅一定不可用。登录和日常管理请使用 nodebuf.com。订阅的访问密钥、文件权限和设备限制依然有效,绑定域名不会把私有资源变成公开内容。
橙云接入时要留意什么
橙云会使公开 DNS 隐藏 CNAME,返回的边缘 IP 也可能与 nodebuf.com 不同。Nodebuf 不会仅靠 IP 相同就放行:系统会检查本人的 TXT、全部公网地址、Cloudflare 的 hostname / SSL 状态,并通过有时效的签名 HTTPS 探测,确认这个域名实际回到本站。请保留 /.well-known/nodebuf-domain-route/ 验证路径正常访问。
在你的 Cloudflare 设置里,不要对订阅或上述验证路径启用交互式人机验证、Cloudflare Access 登录、跳转到其他网站,或“缓存所有内容”。订阅客户端不会像浏览器一样完成登录和人机验证,强制缓存也可能让客户端收到过期内容。HTTPS 证书验证应保持开启,无需改成不校验证书。
页面若提示“HTTPS 验证请求没有正确回到本站”,先检查 CNAME 目标,再核对这些拦截规则,调整后重新验证即可。开启橙云不改变订阅、文件和短链接的账号归属,也不开放自定义域名访问主站页面。
常见问题
CNAME 不匹配
先确认目标是 nodebuf.com,而不是旧的 ingress 入口。检查同名 A/AAAA 冲突、重复域名后缀,以及 CNAME 是否真正指向 Nodebuf。橙云会隐藏公开 CNAME,解析 IP 与主站不同并不单独代表错误。等待 DNS 缓存更新后重试。根域名还应确认服务商支持展平。
TXT 没有找到或不匹配
复制当前账号页面显示的值,确认记录名包含正确的子域名层级。不要删除正在验证的记录,也不要使用旧截图或另一个账号的 TXT。名称含有两遍根域名时,改成服务商要求的相对名称。
域名 active,但 SSL 仍在等待
这两个状态相互独立。先补齐页面列出的 TXT,再稍后重新验证。不要仅凭浏览器偶尔可以打开页面就认为证书签发完成。持续失败时,检查 DNS 服务商是否有严格的 CAA 限制,并把错误代码提供给管理员。
删除后仍显示“删除待确认”
Nodebuf 会先停止接入,再通过 Cloudflare 删除,并确认远程记录已经不存在。网络异常时保留这条记录和名额,避免遗漏远程对象。稍后再点击移除,不必重复添加同名域名。删除域名不会删除订阅、文件或主站链接。
提示达到数量上限
每个账号最多 10 个,全站由应用限制为 100 个。待验证和删除未确认的记录也会占用名额。管理员可以在“文件与链接 → 自定义域名管理”查看、验证、停用和删除记录;普通用户不能删除其他人的域名。
现在还没改 DNS,会马上停用吗
已有 DNS-only 接入保留迁移兼容,程序不会在这次更新中替你修改 DNS 或删除旧记录。不过,请尽快按新页面迁移;切换时先保留主站完整链接,并等 Cloudflare 域名和证书都准备好后再在客户端使用。
最后检查一次
- 本人的 CNAME 已指向
nodebuf.com;Cloudflare 域名推荐橙云,灰云也可。 - 本人的
_nodebufTXT 和页面要求的额外 TXT 都已添加。 - 域名状态、SSL 状态均已 active,页面显示可使用。
- 客户端使用的是带路径和参数的完整订阅地址。
- 主站原链接已保留,订阅密钥没有贴到公开讨论区。
需要帮助时,请通过 站内私信 联系管理员,提供域名、错误代码、DNS 类型和代理状态即可。不要发送 Cloudflare Token、密码或完整私密订阅链接。