如何在 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.com | CNAME | www | <user>.github.io 或 <organization>.github.io |
其他子網域,例如 blog.example.com | CNAME | blog | <user>.github.io 或 <organization>.github.io |
根網域 example.com | A(4 筆都要新增) | @ | 185.199.108.153、185.199.109.153、185.199.110.153、185.199.111.153 |
| 根網域,支援 IPv6 | AAAA(4 筆都要新增,和 A 紀錄並存) | @ | 2606:50c0:8000::153、2606:50c0:8001::153、2606:50c0:8002::153、2606:50c0:8003::153 |
| 根網域,而且你的 DNS 供應商支援 ALIAS 或 ANAME | ALIAS 或 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 Free | GitHub 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 日以英文讀取。這些頁面沒有標示日期。
相關文章
- 2026 年 Netlify 替代方案:比較 5 個服務免費提供的內容把 Convika、Cloudflare Pages、Vercel、GitHub Pages 和 Render 與 Netlify 比較:免費額度、自訂網域、表單、訪客統計和價格,於 2026 年 11 月 17 日查證。
- 如何把 HTML 檔案分享成任何手機都能開啟的連結把檔案上傳到代管服務,再傳送連結;電子郵件和 Google 雲端硬碟傳過去的是程式碼。比較從 Convika 到 Netlify Drop 的 8 個代管服務,附 4 個步驟。
- 如何把 ChatGPT 做的 HTML 頁面免費發布或分享成線上網站ChatGPT 做的 HTML 要放哪裡:比較 Convika、Netlify Drop、GitHub Pages、Cloudflare Pages、Tiiny Host 和 ChatGPT Sites 的免費額度、網域和表單。
- 如何把 Claude 工件分享成連結,或放到真正的網址上大多數用連結分享的 Claude 工件,現在不需要 Claude 帳號就能開啟。用 Claude Free,或需要表單、自己的網域、造訪次數時,就把程式碼發布出去。