使用自訂網域
將已發布的 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(移除網域),再綁定新的主機名稱。 |