網域
選擇一個網域，將它連接到你的專案，安全地管理 DNS，並驗證最終位址可透過 HTTPS 正常運作。
網域是訪客用來存取已發佈專案的網站位址。每個已發佈的 Atoms 專案都會獲得一個由 Atoms 代管的免費位址。實際的公開後綴可能會因部署而異。如果你的方案包含自訂網域，你也可以連接自己已擁有的網域，或透過網域管理流程購買新網域。
從你的目標開始
在選擇路徑之前，你不需要先了解 DNS。選擇符合你想做事情的選項，然後依照下方對應步驟操作。
選擇符合你目標的路徑
| 目標 | 前往位置 |
|---|---|
| 使用免費的 Atoms 位址 | Settings > Domains > 找到預設的 .atoms.world URL > Edit |
| 連接你已擁有的網域 | Settings > Domains > Connect Existing Domain > Connect domain |
| 購買新網域 | Settings > Domains > Purchase New Domain > Buy new domain |
| 選擇偏好的公開位址 | Settings > Domains > 選擇網域 > Set as Primary |
| 將網域從另一個 Atoms 專案移轉過來 | Settings > Domains > Connect Existing Domain > Connect domain > Connected Domain > Switch > Continue |
| 移除已連接的網域 | Settings > Domains > 選擇網域 > Manage > Disconnect |
開始之前
- 請先發佈專案。
- 若要使用自訂網域，請使用包含自訂網域支援的付費方案。
- 請確認你可以編輯要連接之確切主機名稱的 DNS 記錄。
- 先確認該網域目前生效的 DNS 是由哪個服務管理。這可能與你註冊網域的公司不同。
- 在進行變更前，請記錄或匯出現有的 DNS 設定。
- 在替換其 A 或 CNAME 記錄之前，請先確認該主機名稱目前是否已開啟其他網站或服務。
- 保留郵件與無關服務的記錄。不要只是為了連接網站就移除 MX、SPF、DKIM、DMARC 或無關的 TXT 記錄。
必要的網域與 DNS 術語
你只需要了解少數幾個 DNS 概念，就能安全地連接網域。
| 術語 | 意思 |
|---|---|
| 網域 / 主機名稱 | 使用者在瀏覽器中輸入以開啟你網站的位址，例如 example.com 或 app.example.com。 |
| 根網域 / apex 網域 | 你的網域最基本的版本，前面沒有加上任何內容。例如，example.com 就是根網域。像 www.example.com 和 app.example.com 這類位址都是由它延伸而來。 |
| 子網域 | 在主網域前面加上一個字詞的位址。例如，www.example.com、app.example.com 和 shop.example.com 都是 example.com 的子網域。 |
| DNS 供應商 / DNS 主機 | 你管理網域設定的服務。這可能與你購買網域的公司相同，也可能是不同的服務。 |
| DNS 記錄 | 告訴網際網路你的網域應如何運作的設定，例如網站應開啟到哪裡，或 Atoms 如何驗證你的網域。 |
| A 記錄 | 將你的網域指向網站代管伺服器的 DNS 設定。 |
| AAAA 記錄 | 將網域指向 IPv6 伺服器位址的 DNS 設定。大多數初學者在一般 Atoms 設定流程中不需要這個定義。 |
| TXT | 可包含驗證資訊的 DNS 設定。Atoms 可能會要求你新增一筆，以確認你擁有該網域的控制權。 |
| DNS 傳播 | DNS 變更在整個網際網路上都可見所需的時間。在此期間，部分使用者可能仍會看到舊設定。 |
| HTTPS / TLS | 網站連線的安全版本。當你的網域使用 HTTPS 時，訪客與網站之間傳送的資訊會被加密。 |
| Primary Domain | 當你的專案連接了多個網域時，你希望訪客使用的主要網站位址。 |
在你遇到這些術語時也很實用
| Term | What it Means |
|---|---|
| CNAME | 將一個網域位址指向另一個網域位址的 DNS 設定。 |
| Registrar | 為註冊人註冊並續約網域名稱的公司/實體。 |
自訂你的免費 Atoms 位址
當你第一次發佈專案時，Atoms 會在其代管的 Atoms 網域下指派一個穩定的預設子網域。你可以在發佈/更新流程中，將該子網域替換為另一個可用名稱。
- 開啟 Settings > Domains。
- 找到預設的 .atoms.world URL。
- 選擇 Edit。
- 輸入新名稱並選擇 Update。 如果該名稱無法使用，請依照 Atoms 顯示的驗證訊息處理。
- 測試新位址。 開啟新的 .atoms.world URL，並確認預期的已發佈專案可透過 HTTPS 載入。
連接你已擁有的網域
當你的網域是在其他地方註冊，而你希望某個特定主機名稱 - 例如 example.com、www.example.com 或 app.example.com - 開啟你的 Atoms 專案時，請使用此路徑。
選擇確切的主機名稱
在編輯 DNS 之前，先決定訪客應使用哪個主機名稱。根網域及其子網域是不同的主機名稱。例如，如果你希望 example.com 和 www.example.com 兩個位址都能運作，就必須分別連接它們。
開始連接
- 開啟 Settings > Domains。
- 在 Connect Existing Domain 下，選擇 Connect domain。
- 輸入確切的主機名稱，然後選擇 Connect domain 以繼續。
- 可用時請使用輔助設定。 Atoms 可能會識別你的 DNS 供應商，並提供自動連接流程。
- 需要時選擇 Manual Setup。 如果無法使用自動連接，請依照 Atoms 為你的主機名稱顯示的 DNS 記錄繼續操作。
顯示 Manual Setup 時設定 DNS
Atoms 會顯示你正在連接之主機名稱所需的 DNS 記錄。不要假設每種設定都使用相同的記錄類型。依主機名稱與連接方式不同，網站路由可能使用 A 記錄或 CNAME，而驗證可能包含 TXT 記錄。
使用專案中顯示的值
只新增 Atoms 目前為你的主機名稱顯示的記錄類型、主機與值。不要從其他專案或範例複製 IP 位址、CNAME 目標、TXT 主機、驗證 token 或其他 DNS 值。
- 開啟目前生效的 DNS 供應商。 登入為該網域代管即時 DNS 的服務。
- 備份現有記錄。 在進行變更前，請記錄或匯出目前設定。
- 完全依照 Atoms 顯示內容新增每一筆必要記錄。 這可能包含 A、CNAME、TXT 或設定中顯示的其他記錄類型。
- 保護無關服務。 不要刪除郵件記錄或無關的 TXT 記錄。只變更你要連接之主機名稱所需的記錄。
- 儲存 DNS 變更。
- 返回 Atoms，完成連接流程中顯示的確認或驗證步驟。
等待驗證與 HTTPS
儲存 DNS 後，在 Atoms 檢查連接與驗證資訊時，網域可能會顯示「Verifying」。DNS 變更最多可能需要 48 小時才會在全球生效，不過通常會更快更新。在傳播期間，不同網路可能會暫時顯示不同結果。
開啟網域狀態詳細資訊，在 DNS 傳播期間保持記錄不變，然後選擇 Recheck。如果狀態為 Failed，請先依照顯示的錯誤與下一步操作，再重新變更 DNS。
當網域狀態變為 Live 時，請透過 HTTPS 開啟該確切主機名稱，並確認它載入的是預期的已發佈專案。
驗證連接
- 確切的主機名稱會顯示在 Settings > Domains 中。
- 網域狀態為 Live。
- 主機名稱可透過 HTTPS 開啟。
- 載入的是正確的已發佈專案。
- 如果專案有多個路由，巢狀路由或重新整理後的深層連結可正常運作。
- 如果專案使用多個已連接位址，每個位址的行為都符合預期。
根網域、www 與子網域
| 問題 | 處理方式 |
|---|---|
| example.com 和 www.example.com 算是同一個主機名稱嗎？ | 不是。它們是不同的主機名稱。請分別連接並測試你希望訪客使用的每一個。 |
| 可以同時連接根網域與 www 嗎？ | 可以。請分別連接每個主機名稱，然後將偏好的位址設為 Primary Domain。 |
| 可以使用多個子網域嗎？ | 可以。像 app.example.com 和 shop.example.com 這類主機名稱都可以分別設定。 |
| 不同子網域可以指向不同專案嗎？ | 每個主機名稱都可以獨立設定，因此不同子網域可以連接到不同專案。 |
| 同一個主機名稱可以同時連接到兩個專案嗎？ | 一個主機名稱一次應只連接到一個專案。移轉到另一個專案之前，請先解除現有綁定。 |
| 如何連接仍與另一個專案或已刪除專案關聯的網域？ | 在目標專案中，前往 Settings > Domains > Connect Existing Domain > Connected Domain > Switch > Continue。如果此流程中無法使用該網域，請聯絡 Atoms Support。 |
購買新網域
當你想搜尋並註冊新網域，而不是連接已擁有的網域時，請使用 Purchase New Domain。結帳會透過 IONOS 完成。
- 開啟 Settings > Domains。
- 選擇 Purchase New Domain。
- 搜尋網域名稱。 使用搜尋結果查看可用性與價格。
- 將網域加入購物車。
- 透過 IONOS 完成結帳。 提供結帳流程中要求的註冊與付款資訊。
- 完成任何註冊人驗證。 依照註冊商寄送的驗證指示操作，以維持註冊有效。
- 返回 Settings > Domains。 依照 Atoms 顯示的指示完成專案的網域設定。
選擇 Primary Domain
一個專案可以有多個已連接位址，例如免費的 .atoms.world 位址以及一個或多個自訂網域。Primary Domain 是你希望訪客作為偏好公開 URL 使用的位址。設定它會選取偏好的位址；但這本身不會將所有已連接的主機名稱重新導向。
- 開啟 Settings > Domains。
- 找到你要使用的已連接網域。 在將它設為主要網域前，請先確認它可正常運作。
- 選擇 Set as Primary。
- 測試結果。 開啟主要位址並確認它載入的是預期專案。只有在你啟用 Redirect 後，才需另外測試歷史連結的重新導向；Atoms 最多支援重新導向兩個連結。
網域卡片會顯示每個已連接網域的狀態。請先以狀態作為起點，再實際測試主機名稱本身。
| 狀態 | 意思 | 該怎麼做 |
|---|---|---|
| Live | 網域已完成連接與驗證流程。 | 透過 HTTPS 開啟主機名稱，並確認載入的是正確的已發佈專案。 |
| Verifying | Atoms 正在檢查網域連接與驗證資訊。 | 請等待 DNS 傳播，並確認 A/TXT 值與 Atoms 顯示的一致。如果沒有進展，請參考 網域與 SSL 疑難排解 指南。 |
| Disconnected | 網域目前未連接到此專案。 | 如有需要請重新連接，或如果你要從另一個 Atoms 專案移轉，請使用 Switch 流程。 |
| Failed | 連接或驗證程序未成功完成。 | 檢查 Atoms 顯示的錯誤，確認主機名稱與 DNS 值，修正已識別的問題後再重試。 |
安全地中斷連接、切換或替換網域
如果某個網域已經有流量，在移除可正常運作的連接之前，請先驗證目的地或替代項目。這可避免訪客失去可用位址。
將網域從另一個 Atoms 專案移轉過來
1. 開啟目標專案，然後前往 Settings > Domains。
2. 在 Connect Existing Domain 下，選擇 Connect domain。
3. 選擇 Connected Domain。
4. 選擇 Switch，然後 Continue。
5. 驗證結果。 確認預期的專案可透過 HTTPS 載入，且網域狀態為 Live。如果此流程中無法使用該網域，請聯絡 Atoms Support。
中斷網域連接
1. 開啟 Settings > Domains。
2. 選擇已連接的網域，然後選擇 Manage > Disconnect。
3. 驗證剩餘位址。 確認專案仍保有你打算保留的可用位址。
中斷連接或刪除網域。 如果你只是想解除網域與目前專案的綁定，請選擇 Disconnect。如果你想將它從帳戶或網域池中移除，請選擇 Delete Domain。
刪除可能會解除該網域與其他已連接專案的綁定，之後那些專案會還原為預設的 Atoms 位址。此操作需要明確確認，且日後若要重新連接，必須再次新增 DNS 記錄。
以另一個網域替換公開網域
1. 先連接替代網域。
2. 等待替代網域變為 Live。
3. 為替代網域選擇 Set as Primary。
4. 驗證替代網域 與 .atoms.world 備援位址。
5. 透過 Manage > Disconnect 中斷舊網域連接。
6. 僅在確認替代網域後才清理舊 DNS。 如果舊主機名稱不應再指向 Atoms，請只在 DNS 供應商處移除或替換舊的 Atoms 專用記錄。
不要只是為了變更網域而使用 Unpublish
Unpublish 會讓已發佈網站下線。切換或移除網域是獨立的網域管理操作。
連接後上線檢查清單
Live 狀態代表連接已完成，但在將變更視為完成前，仍請做幾項網域相關檢查。
• 在私人/無痕視窗中透過 HTTPS 開啟確切的正式環境主機名稱。
• 確認載入的是預期的 Atoms 專案。
• 如果根網域與 www/子網域都應可運作， 請分別測試每個主機名稱。
• 如果已啟用 Redirect， 請測試每個選取的歷史連結，並確認它會重新導向到偏好的位址。Atoms 最多支援兩個重新導向連結。
• 至少直接開啟一個巢狀路由 並重新整理，以確認主機名稱路由正確。
• 在切換或中斷連接後， 請確認舊主機名稱現在的行為符合預期。
疑難排解與支援
如果已連接的網域未變成 Live 或停止運作，請避免同時變更多個設定。
1. 比對 DNS 記錄。 檢查 Atoms 目前顯示的每一筆記錄，並與你的 DNS 供應商已發佈的記錄逐一比對。依設定不同，這可能包含 A、CNAME、TXT 或連接流程中顯示的其他記錄類型。
2. 確認確切的主機名稱。 請確認你編輯 DNS 的主機名稱，與你在 Atoms 中輸入的是同一個。
3. 等待 DNS 傳播。 DNS 變更最多可能需要 48 小時才會在全球生效。
4. 透過 HTTPS 測試確切的主機名稱。 檢查網站是否載入正確的專案，以及安全連線是否可用。
5. 使用 網域與 SSL 疑難排解。 如果 DNS 記錄正確，但驗證、HTTPS、路由、重新導向或網域管理仍失敗，請依照此專門的疑難排解指南操作。
6. 如果問題持續，請 取得支援 。 請附上專案 Chat Link，以及能清楚顯示問題的螢幕截圖。你可以使用智能體訊息上的 Feedback 選項，或聊天支援入口。
保留一個知名且可用的位址
不要只是為了嘗試不同設定，就移除可正常運作的 DNS 記錄，或反覆中斷並重新連接網域。在確認替代項目之前，請保留 .atoms.world 位址或其他可正常運作的主機名稱。