
對於開發者來說,GitHub Pages 是一個託管靜態網頁的絕佳工具。但原生的網址(例如 username.github.io/repo)往往不夠簡練。如果你擁有了自己的網域,將其綁定到特定的專案上,是建立專業形象的第一步。
以下是將 GitHub Pages 內容對接到自定義子網域的三個關鍵步驟:
一、 在網域供應商設定 DNS 紀錄
首先,你需要登入你的網域管理後台(例如 Cloudflare、GoDaddy 或 Namecheap)。我們需要新增一筆 CNAME 紀錄,這就像是幫你的新地址設定一個轉接頭。- 紀錄類型: CNAME
- 主機名稱(Name/Host): 填入你想設定的子網域前綴(例如
my-project)。 - 目標位址(Value/Target): 填入你原始的 GitHub Pages 網址(例如
username.github.io)。
小提醒: 在目標位址部分,只需要填到 .io 結尾,不需要包含後面的專案路徑。
二、 在 GitHub 倉庫進行配置
完成 DNS 設定後,回到你的 GitHub 專案倉庫中進行連動:
- 點擊倉庫上方的 Settings(設定)分頁。
- 在左側選單中點選 Pages。
- 找到 Custom domain 欄位,輸入你完整的自定義子網域網址(例如
my-project.example.com)。 - 按下 Save 儲存。
此時,GitHub 會在你的專案根目錄自動產生一個名為 CNAME 的檔案,這代表系統已經成功接收到設定。
三、 驗證與安全性設定
儲存之後,GitHub 會開始進行 DNS 檢索與驗證,這通常需要幾分鐘到幾小時不等。
當驗證通過後,別忘了在同一個頁面勾選 「Enforce HTTPS」。這能確保訪客在瀏覽你的網站時,連線是受到加密保護的,這對於現代網站的搜尋排名與安全性至關重要。
結語
透過以上步驟,你就能成功擺脫預設網址,讓專案以更具品牌感的面貌呈現。如果設定後發現無法連線,通常是因為 DNS 擴散需要時間,建議先喝杯咖啡,稍等片刻再回來重新整理頁面!

















