如何在 GitHub Pages 設定自訂網域

快速解答

要在 GitHub Pages 使用自訂網域,請開啟儲存庫的 Settings > Pages,在 Custom domain 輸入網域並點選 Save。接著到 DNS 供應商新增一筆把 www 指向 <user>.github.io 的 CNAME 紀錄,根網域則新增 4 筆 A 紀錄。DNS 變更最多需要 24 小時。Convika 的 Free 方案同樣可以連接你的網域,上傳 HTML 檔案就附表單和 90 天的訪客統計。

把頁面放上我的網域

Free 方案:不需信用卡,1 個自訂網域,上線 1 個頁面,每月顯示 50 筆表單回覆。

本頁內容

要在 GitHub Pages 網站使用自訂網域,請開啟儲存庫的 Settings > Pages,在 Custom domain 輸入網域,再點選 Save。接著到你的 DNS 供應商新增 DNS 紀錄:一筆把 www 指向 <user>.github.io 的 CNAME 紀錄,如果是根網域 example.com,則新增 4 筆 A 紀錄。DNS 變更最多需要 24 小時才會生效,之後再選取 Enforce HTTPS。

以下的步驟和所有 DNS 值都來自 GitHub 的文件,於 2026 年 11 月 17 日讀取。GitHub 的畫面只有英文,所以按鈕名稱以英文標示。

GitHub Pages 需要的 DNS 紀錄

你的網域紀錄類型名稱值
www.example.comCNAMEwww<user>.github.io 或 <organization>.github.io
其他子網域,例如 blog.example.comCNAMEblog<user>.github.io 或 <organization>.github.io
根網域 example.comA(4 筆都要新增)@185.199.108.153、185.199.109.153、185.199.110.153、185.199.111.153
根網域,支援 IPv6AAAA(4 筆都要新增,和 A 紀錄並存)@2606:50c0:8000::153、2606:50c0:8001::153、2606:50c0:8002::153、2606:50c0:8003::153
根網域,而且你的 DNS 供應商支援 ALIAS 或 ANAMEALIAS 或 ANAME,取代 A 紀錄@<user>.github.io 或 <organization>.github.io

GitHub 文件裡有三條規則最能幫你省時間:

  • CNAME 的值不含儲存庫名稱。GitHub 表示,這筆紀錄一律指向 <user>.github.io 或 <organization>.github.io,不加儲存庫名稱,專案網站也一樣。
  • 先在 GitHub 加入網域,再去改 DNS。GitHub 提醒:先設定 DNS,可能讓別人在你的某個子網域上架設網站。
  • 不要用萬用字元紀錄。GitHub 強烈建議不要使用 *.example.com,它會讓網域立刻面臨被接管的風險。

5 個步驟設定自訂網域

在帳號中驗證網域

GitHub 建議先驗證網域,再把它加入儲存庫。點選你的大頭貼,再依序點選 Settings、側邊欄的 Pages 和 Add a domain。輸入網域,選取 Add domain,然後建立 GitHub 顯示的 TXT 紀錄,名稱是 _github-pages-challenge-USERNAME.example.com。紀錄生效後,點選 Verify。請保留這筆 TXT 紀錄:它讓網域維持已驗證的狀態,其他 GitHub 帳號就無法在這個網域或它的直屬子網域上發布網站。

把網域加入儲存庫

在網站的儲存庫中點選 Settings,再點選「Code, planning, and automation」下的 Pages。在 Custom domain 輸入 www.example.com 或 example.com,然後點選 Save。如果網站是從分支發布,這個動作會建立一個 commit,在來源分支的根目錄加入 CNAME 檔案。如果是用 GitHub Actions 工作流程發布,就不會建立 CNAME 檔案,也不需要它。

新增 DNS 紀錄

到你的 DNS 供應商新增上表的紀錄:子網域新增一筆 CNAME,根網域新增 4 筆 A 紀錄。如果供應商在同一個名稱上預設了一筆紀錄,請先把它刪除。GitHub 建議在設定根網域時一併設定 www:兩者都設定好之後,GitHub Pages 會把其中一個重新導向另一個。

檢查紀錄

DNS 變更最多需要 24 小時。要從終端機檢查:

dig www.example.com +nostats +nocomments +nocmd
dig example.com +noall +answer -t A

第一行會顯示指向 <user>.github.io 的 CNAME,第二行會顯示 4 筆 A 紀錄。Windows 沒有 dig,請在 PowerShell 使用 Resolve-DnsName。

開啟 Enforce HTTPS

回到 Settings > Pages,選取 Enforce HTTPS。DNS 檢查通過後,GitHub 會自行向 Let's Encrypt 申請憑證,完成時會在網域旁邊顯示勾號。這個選項最多可能要等 24 小時才能使用。

www、根網域,還是兩個都用

GitHub 建議一律使用 www 子網域,即使你也使用根網域,因為 www 子網域不受 GitHub 伺服器 IP 位址變更的影響。把你希望訪客看到的那一個設為自訂網域,並為兩者都新增 DNS 紀錄:

  • 自訂網域設為 www.example.com,再加上根網域的 A 紀錄:example.com 會重新導向 www.example.com。
  • 自訂網域設為 example.com,再加上 www 的 CNAME:www.example.com 會重新導向 example.com。

使用者網站或組織網站的自訂網域,也會套用到該帳號的專案網站:使用者網站是 www.octocat.com 時,儲存庫 octo-project 會在 www.octocat.com/octo-project 開啟。

GitHub Pages 自訂網域無法使用時的修正方式

  • 部署之後自訂網域消失。對發布分支執行 force push 的建置流程會覆寫 CNAME 檔案。請把這個檔案放進原始碼,讓每次建置都包含它。檔名全部大寫,內容只有一個網域,沒有其他東西。
  • 「Domain is already taken」。另一個儲存庫佔用了這個網域。在你的帳號中驗證網域,就能把它從其他使用者的網站釋出,或是在另一個儲存庫的 Custom domain 點選 Remove。
  • Enforce HTTPS 無法選取,或出現「Certificate not yet created」。設定網域後,HTTPS 最多可能需要一小時。如果卡住了,點選網域旁邊的 Remove,重新輸入網域再點選 Save,憑證申請就會重新開始。@ 上多餘的 A、AAAA、ALIAS 或 ANAME 紀錄,或是子網域上的第二筆 CNAME,都可能擋住憑證。如果網域有 CAA 紀錄,其中一筆必須允許 letsencrypt.org。
  • 網站在 www 打得開,根網域卻打不開,或是相反。打不開的那個名稱沒有紀錄。為根網域新增 4 筆 A 紀錄,或為 www 新增 CNAME。不要把子網域的 CNAME 指向你的根網域:GitHub 表示這樣會讓 HTTPS 失效。
  • 開啟 HTTPS 後圖片或樣式不見了。頁面是用 http:// 載入它們。把這些網址改成 https://。
  • 舊網址還打得開。清除瀏覽器的快取。

一個網站可以有一個根網域和一個 www 子網域。GitHub 的文件指出,同一個網站不支援一個以上的根網域、一個以上的 www 子網域,也不支援根網域搭配另一個自訂子網域。

GitHub Pages 對網域背後的網站有什麼要求

  • GitHub Free 需要公開的儲存庫。使用 GitHub Free 時,Pages 可用於公開的儲存庫;私人儲存庫則要 GitHub Pro 以上。不論哪一種,發布後的網站都是公開的。
  • 不能經營線上生意。GitHub 的限制頁面表示,Pages 的用途不是、也不允許當作免費的網站代管服務,來經營你的線上生意、電子商務網站,或任何主要用來促成商業交易或提供商業軟體即服務(SaaS)的網站。界線在哪裡,請看〈GitHub Pages 的商業使用〉(英文)。
  • 只放檔案。Pages 是靜態網站代管服務,所以聯絡表單或報名表單需要另外的服務。
  • 大小和流量。網站最大 1 GB,頻寬的彈性上限是每月 100 GB。其餘的限制請看〈GitHub Pages 的限制〉(英文)。

有表單和訪客統計的自訂網域:Convika

要接受報名、預約或訂單的頁面,光是把檔案放上線還不夠。在 Convika,Free 方案就能把你的網域連接到你上傳的頁面,不需要儲存庫,也不需要建置,而且每個方案都允許商業使用。

Convika FreeGitHub Pages
你發布的內容在瀏覽器上傳的 HTML 檔案、資料夾或 ZIP,或是從 AI 對話貼上的程式碼GitHub 儲存庫裡的檔案;GitHub Free 需要公開的儲存庫
自訂網域1 個,例如 www.yourbrand.com子網域或根網域
DNS 紀錄www 用一筆 CNAME 和一筆 TXT;一筆 A 紀錄把 yourbrand.com 導向它www 用一筆 CNAME;根網域用 4 筆 A 紀錄;驗證用一筆 TXT
HTTPS找到紀錄後自動核發自動核發;你要選取 Enforce HTTPS
用來販售的網站每個方案都允許不允許用於線上生意或電子商務網站
會保存回覆的表單有:回覆會保存、寄到你的信箱,並可匯出成 CSV 或 JSON;每月顯示 50 筆只放檔案
訪客統計90 天的造訪次數、來源網站、UTM 活動、裝置、國家和按鈕點擊文件沒有提到
價格US$0,帶有 Convika 橫幅;Pro 每月 US$12免費

要把頁面搬過去,請從儲存庫下載它的 index.html,或是包含 CSS 和圖片的資料夾,再拖放到 Convika 的上傳框。點選「保留這個頁面:免費,不需信用卡」,再依序點選「發布頁面」、「公開」、「下一步」和「免費發布」。在頁面的畫面上點選「Connect my domain」(連接我的網域;主控台以英文顯示這個按鈕),加入 www.yourbrand.com,再把指向 <user>.github.io 的 CNAME 換成 Convika 顯示的那一筆。〈把頁面放上你自己的網域〉(英文)說明每一個畫面,〈HTML 聯絡表單程式碼〉(英文)有可以直接複製的表單。

想比較更多服務,請看〈GitHub Pages 的替代方案〉(英文)。

Skipbox

又便宜又快的 GitHub Actions Runner,每月 $39 吃到飽

專屬機器會在各作業之間保留 Docker 映像層和套件快取。只要改一行 runs-on 就能切換。

免費試用 Skipbox⁠

常見問題

GitHub Pages 可以免費使用自訂網域嗎?

可以。GitHub Pages 連接自訂網域不收費,條件是使用 GitHub Free 的公開儲存庫。你只需要向網域註冊商支付網域本身的費用。Convika 的 Free 方案也能連接 1 個自訂網域,上傳 HTML 檔案就附表單和訪客統計。

GitHub Pages 需要哪些 DNS 紀錄?

www 或其他子網域需要一筆指向 <user>.github.io 的 CNAME 紀錄。根網域需要 4 筆 A 紀錄:185.199.108.153、185.199.109.153、185.199.110.153 和 185.199.111.153,或是一筆指向 <user>.github.io 的 ALIAS 或 ANAME 紀錄。要支援 IPv6,就在 A 紀錄之外再新增 4 筆 AAAA 紀錄。

GitHub Pages 的自訂網域要多久才會生效?

最多 24 小時。GitHub 的文件表示,DNS 變更最多需要 24 小時才會生效,設定網域後 HTTPS 最多可能需要一小時,而 Enforce HTTPS 選項最多可能要等 24 小時才能使用。

為什麼我無法在 GitHub Pages 開啟 Enforce HTTPS?

憑證還沒有核發。設定網域後請等最多一小時。如果還是無法使用,就移除自訂網域再加回去,讓申請重新開始;刪除同一個名稱上多餘的 A、AAAA 或 CNAME 紀錄;並確認所有 CAA 紀錄都允許 letsencrypt.org。完整的網域名稱必須少於 64 個字元。

CNAME 紀錄要指向我的儲存庫網址嗎?

不用。請指向 <user>.github.io 或 <organization>.github.io,不加儲存庫名稱,專案網站也一樣。GitHub 也表示,不要把它指向儲存庫 Pages 設定中顯示的 *.pages.github.io 位址。

私人儲存庫可以在 GitHub Pages 使用自訂網域嗎?

要 GitHub Pro 以上。使用 GitHub Free 時,Pages 只能用於公開的儲存庫。兩種情況下,網站本身在網路上都是公開的。細節請看〈GitHub Pages 與私人儲存庫〉(英文)。

我可以把 GitHub Pages 的自訂網域用在公司或店家的網站嗎?

GitHub 表示,Pages 不允許用來經營線上生意、電子商務網站或 SaaS。Convika 的 Free 方案允許商業使用,可以把你的網域連接到同樣的 HTML 檔案,還有會保存每一筆詢問的表單。

一個 GitHub Pages 網站可以連接多個網域嗎?

可以連接一個根網域和它的 www 子網域,兩者會互相重新導向。GitHub 的文件指出,不支援一個以上的根網域,也不支援根網域搭配另一個自訂子網域,而且 CNAME 檔案只能有一個網域。

資料來源

全部來自 GitHub Docs,於 2026 年 11 月 17 日以英文讀取。這些頁面沒有標示日期。

你的網域,加上會保存每筆回覆的表單

上傳 HTML 檔案,免費發布,再用 2 筆 DNS 紀錄連接 www.yourbrand.com。不需要儲存庫,HTTPS 自動完成。

把頁面放上我的網域

Free 方案:不需信用卡,1 個自訂網域,上線 1 個頁面,每月顯示 50 筆表單回覆。