使用自定义域名
把已经发布的 Buda Site 指向你自己的域名。
已发布的 Site 会先拥有一个 Buda URL。当你希望公开地址使用自己的品牌时,可以绑定自定义域名,例如 app.example.com。
最简单的方式,是直接告诉 Buda 你的目标:
把这个已发布应用绑定到
app.example.com。
Buda 会绑定主机名并显示准确的 DNS 记录。你只需要把这条记录复制到自己的 DNS 服务商。
开始前
- Site 必须已经部署或发布。
- 你需要有该域名的 DNS 管理权限。
- 优先使用子域名,例如
app.example.com或www.example.com。这是最简单的 CNAME 方式。
绑定域名
让 Buda 绑定域名
在应用对话里告诉 Buda:把已发布的 Site 绑定到你的主机名,例如 app.example.com。Buda 会返回域名状态和 CNAME 目标。
如果你更想用界面操作,进入 Space settings(空间设置)-> Apps & Sites(应用与站点),或 Commander(指挥台)-> Sites。找到已发布的 Site,打开操作菜单,选择 Open details(打开详情),再进入 Settings(设置)-> Custom domain(自定义域名)。
确认主机名
使用完整主机名,不要只填根域名。优先使用 app.example.com 或 www.example.com。如果你在界面中操作,输入完整主机名后点击 Bind domain(绑定域名)。
在 DNS 中添加 CNAME
进入你的 DNS 服务商,添加一条 CNAME 记录:
| 字段 | 值 |
|---|---|
| Name / Host | 子域名前缀,例如 app 或 www |
| Target / Value | Buda 显示的 CNAME target(CNAME 目标),通常是 site-dns.budaapps.com |
删除同一主机名下冲突的 A、AAAA 或 CNAME 记录。
如有验证记录,照抄添加
多数情况下只需要 CNAME。如果 Buda 还显示 DNS ownership verification(DNS 所有权验证),按原样添加对应 TXT 记录。如果显示 HTTP ownership verification(HTTP 所有权验证),按原样复制这些值,并在切换流量前由当前站点提供该验证 token。
等待生效,然后打开域名
DNS 通常几分钟内生效,但有时会更久。等待期间不要在 Buda 中移除该域名。解析完成后,在 Custom domain 面板打开 https://你的域名。验证通过后,Buda 会自动处理 HTTPS。
更换或移除
如果要换域名,先移除当前自定义域名,再绑定新的主机名。每个 Site 同一时间只能绑定一个自定义域名。
对于 example.com 这样的根域名,很多 DNS 服务商不允许普通 CNAME。优先使用 www.example.com 或 app.example.com;如果服务商支持,也可以使用 ALIAS、ANAME 或 CNAME flattening。
快速排查
| 问题 | 检查项 |
|---|---|
| Bind domain(绑定域名) 不可点 | Site 还没有部署,或已经绑定了一个自定义域名。 |
| 域名仍打开旧站点 | 删除冲突 DNS 记录,并确认 CNAME 目标与 Buda 显示完全一致。 |
| HTTPS 还不可用 | 等 DNS 解析完成后再试。证书会在验证通过后开始配置。 |
| 想换另一个域名 | 先点击 Remove domain(移除域名),再绑定新的主机名。 |