自訂網域的對應與 DNS 驗證

自訂網域自訂域名 DNS CNAME SSL HTTPS 店鋪應用程式品牌識別

店鋪應用程式的 Web 頻道在初始狀態下，會以 https://app.receiptroller.io/your-store 這樣的預設共用網域路徑公開發布。若對應店家的自訂網域（例如：app.your-store.com），即可用與品牌一致的網址提供給顧客。SSL 憑證（HTTPS）也會自動發行，店家無需自行購買或更新憑證。

本文將說明自訂網域的新增方法、DNS 記錄的設定、驗證流程，以及常見的疑難排解方式。

使用自訂網域的優點

品牌一致性 — 可以將店鋪官網、名片、社群媒體的所有連結統一為同一網域
提升顧客信任感 — 容易被辨識為「本店的網址」，也較不容易與釣魚網站混淆
行銷用途 — 可在傳單或看板上標示如 app.your-store.com 的網址，也更容易統計來自社群媒體或搜尋的流量

事前準備事項

店家所擁有的網域 — 已在 Google Domains、Cloudflare、AWS Route 53 等註冊商取得的網域
可編輯 DNS 記錄的權限 — 能夠存取註冊商或 DNS 服務商的管理畫面
店鋪應用程式的 Web 頻道已公開 — 目前以預設共用網域網址正常顯示的狀態

子網域 vs 根網域

自訂網域有兩種使用方式。

子網域（建議）：如 app.your-store.com 或 shop.your-store.com，在根網域前方加上前綴的形式。只需新增一筆CNAME 記錄即可完成設定，維護也較容易
根網域（裸網域）：your-store.com 本身。需使用 ANAME / ALIAS / Flattened CNAME 記錄等方式，依註冊商不同，對應方式也不同。僅限您使用的註冊商支援這些記錄類型時才可設定

多數情況下，建議店鋪官網的根網域（your-store.com）維持原樣，另外切出專用於店鋪應用程式的子網域使用。

設定步驟

在店鋪管理畫面新增網域：開啟「店鋪應用程式」→「設定」→「自訂網域」，點選「新增網域」。輸入想要設定的網域（例如：app.your-store.com）
確認驗證用 DNS 記錄：畫面上會顯示用於驗證的 TXT 記錄，以及正式使用的 CNAME 記錄。例如：
- 驗證用：_rr-verify.app.your-store.com TXT rr-verify=abc123...
- 正式使用：app.your-store.com CNAME stores.receiptroller.io
在註冊商新增 DNS 記錄：在您使用的註冊商的 DNS 設定畫面，新增上述兩筆記錄（具體步驟依註冊商不同，常用註冊商的設定方式請參考下方「各主要註冊商的設定方式」）
執行驗證：返回店鋪管理畫面，點選「執行驗證」。系統會自動檢查 DNS
SSL 憑證自動發行：驗證完成後，會自動發行用於 HTTPS 的 SSL 憑證，通常在數分鐘內生效
公開發布：點選「公開發布」後，即可透過自訂網域存取店鋪應用程式

各主要註冊商的設定方式

お名前.com：DNS 關聯功能 → DNS 記錄設定 → 從「新增」加入 TXT 與 CNAME。生效時間約 30 分鐘～數小時
Cloudflare：DNS 分頁 → Add record。新增 CNAME 時，請將 Proxy（橘色雲朵圖示）設定為關閉（保持開啟狀態會導致驗證無法通過）
AWS Route 53：Hosted zone → Create record。Type 選擇 CNAME / TXT
Google Domains（現為 Squarespace）：DNS → 自訂記錄 → 新增
Value Domain：DNS 設定 → 直接編輯 DNS 記錄

各註冊商的顯示名稱有所不同，若有不清楚之處，請洽詢註冊商的客服支援，或聯繫我們的客服團隊。

DNS 生效所需時間

新增 DNS 記錄後，全球 DNS 伺服器完全同步約需數分鐘至最長 72 小時。多數情況下會在數十分鐘內生效，但依 TTL（Time To Live）設定不同，有時也可能需要較長時間。

系統每 5 分鐘會自動重新執行驗證，因此即使未立即通過，稍等片刻後再次確認即可，不需要擔心。

SSL 憑證（HTTPS）

自訂網域驗證完成後，會自動發行 SSL 憑證。憑證由 Let's Encrypt 發行，每 90 天會自動更新一次。店家無需自行購買、更新憑證，也不必擔心忘記更新。

透過 HTTP（未加密）存取時，會自動重新導向至 HTTPS。

多個自訂網域

一個店鋪應用程式也可以設定多個自訂網域。例如同時設定 app.your-store.com 與 shop.your-store.com，讓顧客可以透過任一網址存取。將其中一個指定為主網域後，其他網域會自動重新導向至主網域。

變更、解除自訂網域

自訂網域之後也可以變更或解除。

變更：保留舊網域的設定，新增並驗證新網域，即可無停機時間完成切換。即使舊網址已被加入書籤，也能透過重新導向繼續為顧客提供服務
解除：在「自訂網域」畫面點選對象網域的「刪除」。顧客的存取將恢復為預設共用網域網址

疑難排解

驗證無法通過：請等待 DNS 生效後再試一次。請確認在註冊商的管理畫面中記錄是否正確登錄
在 Cloudflare 驗證無法通過：請將 CNAME 的 Proxy 設定關閉（DNS only／灰色雲朵）。驗證完成後再切回開啟狀態也沒有問題
顯示「SSL 憑證發行失敗」：可能是因為 CAA 記錄限制了該網域的憑證發行。請確認 CAA 記錄中是否包含 letsencrypt.org，或考慮刪除 CAA 記錄
透過 HTTPS 存取時出現警告：憑證剛發行後，有時會因快取而短暫出現警告。請等待數分鐘後再重新存取
透過自訂網域開啟卻回到原本的網址：請先清除瀏覽器快取後再試一次。若仍未解決，請確認 CNAME 記錄的拼字是否正確

可使用的方案

使用自訂網域功能，店家的方案必須為Starter 以上（各方案可使用的功能請參考另一篇文章「方案與角色的關係」）。