2026 零成本建站：GitHub Pages + Actions 自动化部署全指南

GitHub Pages 是 GitHub 提供的 静态网站托管服务，可将你仓库中的 HTML、CSS、JavaScript 文件直接部署成网站。

特点：

免费：个人账户或组织账户均可使用
无服务器管理：无需购买 VPS 或配置 Web 服务器
自动化部署：通过 Git Push 自动更新网站内容
HTTPS 支持：自带免费 TLS 证书

简言之，你的 GitHub 仓库就可以直接变成一个静态网站，方便展示项目、博客或文档。

2. 工作原理#

GitHub Pages 的核心原理：

仓库文件作为源
- 你在 GitHub 仓库的 main/master 或 gh-pages 分支上传网站文件
GitHub 解析生成静态网页
- 对 HTML、CSS、JS 直接托管
- 支持 Jekyll 等静态网站生成器，自动构建网站
通过 GitHub 提供的域名访问
- 默认域名：https://用户名.github.io/仓库名
- 支持自定义域名绑定

示意：仓库 → GitHub 构建 → 网站托管 → 用户访问

3. 创建 GitHub Pages 网站#

方法一：用户/组织网站#

创建一个仓库，命名规则：<用户名>.github.io
上传 HTML 文件（如 index.html）
设置仓库 Pages：
- 打开仓库 → Settings → Pages
- Source 选择 main 或 gh-pages 分支
- 保存即可
访问网站：

1
https://<用户名>.github.io

方法二：项目网站#

在任意仓库中创建分支（如 gh-pages）
上传网站文件
设置 Pages 源：
- 打开仓库 → Settings → Pages
- Source 选择 gh-pages 分支或 docs 文件夹
访问网站：

1
https://<用户名>.github.io/<仓库名>/

4. 支持静态网站生成器#

GitHub Pages 原生支持 Jekyll：

可以通过 Markdown 文件生成博客或文档网站
支持主题（Theme）、插件和模板
更新内容只需提交 Markdown 或 HTML 文件，GitHub 自动构建网站

其他静态网站生成器（Hugo、Hexo、VuePress 等）可通过 本地生成静态文件，再推送到 GitHub Pages 分支实现部署。

5. 自定义域名与 HTTPS#

绑定自定义域名#

仓库 Settings → Pages → Custom domain
填写你的域名（如 example.com）
配置域名 DNS：

1
A 记录：指向 185.199.108.153
2
CNAME：指向 <用户名>.github.io

开启 HTTPS#

GitHub Pages 默认提供免费 TLS 证书
在 Pages 设置中勾选 Enforce HTTPS 即可

6. GitHub Actions 自动部署#

为了实现 CI/CD，可以使用 GitHub Actions 自动部署：

1
name: Deploy Pages
2
on:
3
  push:
4
    branches:
5
      - main
6

7
jobs:
8
  build-and-deploy:
9
    runs-on: ubuntu-latest
10
    steps:
11
      - uses: actions/checkout@v3
12
      - name: Build site
13
        run: |
14
          # 静态站点生成命令，例如 Hugo、Hexo
15
      - name: Deploy to GitHub Pages
16
        uses: peaceiris/actions-gh-pages@v3
17
        with:
18
          github_token: ${{ secrets.GITHUB_TOKEN }}
19
          publish_dir: ./public

每次 push 到 main 分支，自动构建并推送到 gh-pages 分支
网站实时更新，无需手动操作

7. 使用场景#

个人博客
- 使用 Jekyll、Hexo 或 Hugo，快速搭建博客
开源项目文档
- 项目 README、API 文档、用户指南
静态演示站
- HTML、JS 动态网页或前端项目演示
Markdown 笔记库
- 知识整理、电子书或笔记分享

8. 优势与局限#

优势#

免费、零运维
自动 HTTPS 支持
与 GitHub 生态无缝结合
支持自定义域名和 CI/CD 自动部署

局限#

仅支持 静态内容，无法运行后端逻辑
每次部署需通过 Git Push 或 Actions
高流量或复杂动态网站需配合 Cloudflare 等 CDN 或后端服务

9. 总结#

GitHub Pages 是开发者和自托管爱好者部署静态网站的利器：

零成本、零运维：不需要购买服务器
自动构建和部署：通过 Git Push 或 Actions 即可更新网站
支持自定义域名和 HTTPS：安全访问
适合博客、文档、静态演示

对于想快速上线个人项目、博客或开源文档的人来说，GitHub Pages 是首选方案。

音乐