云平台绑定域名

推荐主线：先把域名托管到 Cloudflare，再来绑定云平台域名。这样后面统一在 Cloudflare 填记录，不用再判断在哪里填。

还没有托管到 Cloudflare：先看推荐：把域名托管到 Cloudflare。已经托管好了，再继续本页。

不想托管到 Cloudflare：也可以先看本页对应平台的"添加域名并拿到记录"步骤；拿到 Type、Name / Host、Value / Target 后，回不托管 Cloudflare：域名商直接解析，不要继续看本页后面的 Cloudflare 填记录主线。

先选你的云平台

先在云平台添加域名。云平台会告诉你要填什么记录。你只负责复制它给出的 Type、Name / Host、Value / Target，不要自己编。

Vercel
Hugging Face Space
Netlify
Cloudflare Workers
EdgeOne Pages

第一步：在云平台添加域名并拿到记录

Vercel：按项目提示加域名，再回 DNS 补记录

如果这条线前面还没跑通，先回：

第 1 步：进入项目的 Domains，然后点 Add Domain

路径：Project → Settings → Domains → Add Domain

一次只加一个域名，例如 example.com
如果还要绑定 www.example.com，等前一个加完后再加一次
保存后先别关页面，下一步要照这里给的记录继续填

Vercel Domains 页面添加自定义域名截图

先把域名交给 Vercel。后面该填什么记录，以你自己当前页面显示的内容为准。

第 2 步：如果 Vercel 当前页面只让你填一条 A 记录，就按这一种走

Vercel 提示根域名使用 A 记录截图

你如果看到的是这一种页面，就只需要记下这一条 A 记录，下一步去 Cloudflare 把它建出来。

第 3 步：如果 Vercel 当前页面让你填 TXT 和 CNAME，就按这一种走

Vercel 提示 TXT 和 CNAME 两条记录截图

你如果看到的是这一种页面，就记下这两条记录。下一步去 Cloudflare 时，要分成两条分别建，不要合成一条。

第 4 步：先完成 DNS 记录（必须）

不要跳过这一步

先看清 Vercel 当前页面给的是哪一种：只给 A 记录，就只建一条 A；给 TXT 和 CNAME，就分成两条建。填完 DNS 后，再回 Vercel 继续下一步。

下一步：去 Cloudflare 填记录

第 5 步：回 Vercel，等状态正常后再测试

Vercel 域名配置生效后截图

回到 Vercel，等域名状态正常，再用自己的域名做部署后自检。

Hugging Face Space：先在 Space 里加域名，再按提示补 CNAME

如果这条线前面还没跑通，先回：

先看这里：免费版不支持 Hugging Face Space 自定义域名。看到 Upgrade to PRO to enable Custom Domain，就不能继续绑定，只能用默认 hf.space 地址。

Hugging Face 免费版 Custom Domain 区域提示需要升级 PRO 的实际截图

免费版会提示升级 PRO，Submit 不能点。只有 PRO / Team / Enterprise 版本再继续下面步骤。

如果你是 PRO / Team / Enterprise：确认 Space 是 Public 或 Protected。Private Space 不支持绑定自定义域名。

建议：先绑子域名，例如 api.example.com 或 danmu.example.com。不要一开始就绑根域名 example.com。

第 1 步：先确认默认 hf.space 地址能打开

先打开默认地址。默认地址能看到 danmu_api 页面，并且已经按部署后自检跑通过弹幕测试后，再继续绑域名。

Hugging Face Space 已经 Running 并能打开 danmu_api 管理界面的实际截图

先确认 Space 是 Running，默认 hf.space 地址能访问。

第 2 步：进入 Space 的 Settings

路径：你的 Space → Settings → Custom Domain

打开自己的 Space，点顶部 Settings，往下找到 Custom Domain。

Hugging Face Space 顶部 Settings 入口截图

先点 Space 顶部的 Settings。图里的账号名已打码。

第 3 步：填入完整子域名

在 Custom Domain 输入框里填完整域名，例如：

api.example.com

不要只填 api，也不要一次填多个域名。

Hugging Face 官方文档里 Custom Domain 输入框截图

这里填完整子域名，例如 api.example.com。

第 4 步：点 Submit，看 Hugging Face 给出的解析要求

点 Submit 后，页面会变成 pending，并给出一张 DNS 表格。

你只需要看这三列：

页面列名	要做什么
Record type	记录类型，一般选 `CNAME`
Host	要解析的域名，就是你刚填的子域名
Target	解析目标，通常是 `hf.space`

Hugging Face 官方文档里 Custom Domain pending 状态和 CNAME 记录提示截图

看到 pending 先别急。下面这张表就是下一步要回 Cloudflare 填写的内容。

第 5 步：先完成 DNS 记录（必须）

不要跳过这一步

Hugging Face 给出的 Record type、Host、Target 就是要填写的内容。填完 DNS 后，再回 Hugging Face 等状态变化。

下一步：去 Cloudflare 填记录

第 6 步：回 Hugging Face，等 pending 变成 ready

保存 DNS 记录后，回到 Space 的 Settings → Custom Domain。

还是 pending：继续等 DNS 生效
变成 ready：域名已经接上
一直不变：用下面的 CNAME 查询工具检查是否已经指向 hf.space

查询时打开： Google CNAME 查询工具

Google Admin Toolbox 查询 CNAME 的页面截图

填自己的完整域名，查询类型选 CNAME。结果里能看到 hf.space，再回 Hugging Face 等状态变成 ready。

第 7 步：用自己的域名做部署后自检

状态变成 ready 后，把部署后自检里的 你的域名 换成刚绑定好的域名，按那一页重新跑一遍弹幕测试。自动匹配和手动匹配都能拿到弹幕，就说明自定义域名已经接上。

Netlify：先加域名，再按 Domain management 提示补 DNS

如果这条线前面还没跑通，先回：

第 1 步：先点进你自己的站点

Netlify Site overview 截图

先进入你自己的站点，别停在 team 总览。域名这条线从站点里继续走。

第 2 步：进入 Domain management

Netlify Domain management 截图

进入 Site configuration 里的 Domain management。后面的添加域名和看 DNS 提示，都在这里。

第 3 步：先把自己的域名加进去

点 Add domain alias 或同类入口
一次只填一个域名
保存后留在当前页，下一步继续看 Netlify 提示

Netlify 添加域名别名截图

这一步只做一件事：把要绑定的域名正确加到 Netlify 里。

第 4 步：看到 Awaiting external DNS 后，先抄下 Netlify 当前页面要求的记录

Netlify Awaiting external DNS 状态截图

看到 Awaiting External DNS 后，不要自己猜。先把 Netlify 当前页面要求的记录类型和值看清楚，再去改 DNS。

第 5 步：先完成 DNS 记录（必须）

不要跳过这一步

Netlify 当前页面让你填什么，就照抄什么。填完 DNS 后，再回 Netlify 等状态正常。

下一步：去 Cloudflare 填记录

Cloudflare Workers：优先用 Custom Domain

如果你还没完成部署：先回 Cloudflare Workers 部署，确认默认 Workers 地址能打开，再继续绑定自己的域名。

如果这条线前面还没跑通，先回：

先确认域名已经在 Cloudflare 里：Workers 的自定义域名要求这个域名已经由当前 Cloudflare 账号管理。还没托管的话，先去推荐：把域名托管到 Cloudflare，等状态正常后再回来。

第 1 步：进入 Worker 的 Domains & Routes

路径：Workers & Pages → 你的 Worker → Settings → Domains & Routes

如果你的控制台版本把入口叫 Triggers，也从那里找 Custom Domains 或 Domains & Routes。

第 2 步：点 Add Custom Domain

在 Custom Domains 区域点 Add Custom Domain。这条线适合把整个子域名交给 Worker，例如 api.example.com。

第 3 步：填完整子域名并保存

填完整域名，例如：

api.example.com

保存后按 Cloudflare 页面提示等待证书和域名状态正常，再用这个域名访问 danmu_api 测试。

注意

这条线不要再去下方 Cloudflare DNS 记录小节重复建记录。Custom Domain 是 Worker 自己的域名绑定入口，适合 api.example.com 这种整域名都交给 Worker 的场景。

高级：只有路径级代理才用 Route

如果你的需求是"已有网站继续保留，只让 example.com/danmu/* 这类路径交给 Worker"，才考虑 Route。Route 需要先有对应主机名的 DNS 记录，并写 URL pattern，例如 example.com/danmu/*。新手只想给 danmu_api 绑定一个 API 域名时，不建议从 Route 开始。