Skip to content

建立 2026-09-15 更新 2026-09-15

GitHub Pages

GitHub Pages 是 GitHub 內建的免費靜態網站佈署服務，最大優勢是「程式碼放哪裡、網站就從哪裡來」——不需要額外註冊其他平台帳號，直接利用既有的 GitHub repository 就能上線。很適合專案文件、個人網站、作品集這類純靜態內容；本樣板網站目前也是用 GitHub Pages 佈署。

核心概念

  • 兩種佈署來源：可以選擇「Deploy from a branch」，指定某個分支（例如 gh-pages）的內容直接當作網站；也可以用 GitHub Actions 在每次 push 後自動執行建置流程，再把產出的靜態檔案佈署上去，適合需要先跑建置指令（如 npm run build）的框架。
  • 使用者站台 vs. 專案站台：repository 名稱如果是 <帳號>.github.io，網址就是根網域；其他 repository 則會以 <帳號>.github.io/<repo名稱>/ 的路徑呈現，使用框架時要留意 base path 設定。
  • 不支援常駐後端：GitHub Pages 只能佈署靜態檔案，沒有伺服器可以執行 Node.js、Python 等後端程式；需要 API 或資料庫時要另外找服務，或只在前端呼叫外部 API。
  • 自訂網域：在 repository 的 Settings → Pages 設定 Custom domain，並在網域註冊商設定對應的 DNS 紀錄，GitHub 會自動核發 HTTPS 憑證。

佈署步驟（GitHub Actions 方式）

  1. 在 repository 的 Settings → Pages，將 Source 改為 GitHub Actions。
  2. 在 .github/workflows/ 新增一個工作流程檔案，內容包含：checkout 程式碼 → 安裝依賴 → 執行建置指令 → 使用 actions/upload-pages-artifact 上傳建置產出 → 使用 actions/deploy-pages 完成佈署。
  3. 設定工作流程所需的權限（pages: write、id-token: write）。
  4. git push 到指定分支（例如 main）後，到 repository 的 Actions 分頁確認流程執行成功。
  5. 完成後可在 Settings → Pages 看到正式網址（https://<帳號>.github.io/<repo名稱>/）。

方案與限制

GitHub Pages 對公開 repository 完全免費，是六個平台中最單純的一個；但頻寬與建置次數仍有合理使用限制，且不提供常駐後端運算。詳細規範請見 GitHub Pages 使用限制官方說明。

官方學習資源

官方文件

GitHub Pages 官方文件 與 快速入門指南 是最權威的參考資料，涵蓋兩種佈署方式的完整設定步驟。

GitHub 官方頻道教學

GitHub 官方訓練頻道錄製的入門介紹，示範如何建立 repository、開啟 GitHub Pages 功能，並完成第一個靜態網站的上線，適合完全沒接觸過 GitHub 的讀者當作起點。

精選 YouTube 教學

社群製作的實作教學，完整走一遍把一個靜態網站專案推上 GitHub、開啟 Pages 功能、並取得可公開瀏覽網址的流程，步調適合新手跟著操作。

相關資料