EP09. “GitHub Pages：免费架设静态网站”

• 作品集、活动页、产品说明页这类不需要后台的网站，放 GitHub Pages RM0 主机费就能上线，还有免费 https
• 只支持静态网站（HTML、CSS、JavaScript），不能跑 PHP、不能装 WordPress、没有数据库
• 免费版 GitHub 的仓库要设成 Public 才能用 Pages；私人仓库要付费方案
• 可以绑自己的域名（例如 aidentan.com），DNS 设定跟接 Hostinger 类似
• 以下限制与步骤为 2026-09 查询 GitHub Docs 的资料

重点内容

两种网站类型

用量限制与禁止用途

⚠️ GitHub Pages 不能用来做：网店/线上交易、商业 SaaS 服务、处理密码或信用卡等敏感资料。要收款的网站请用 WooCommerce、Shopify 这类方案。

发布步骤（从分支部署）

第 1 步：准备仓库

• 新建 Public 仓库，把网站文件放进去，首页必须叫 index.html（也可以是 index.md 或 README.md），放在根目录或 /docs 文件夹
• 用 EP05 的方法 push 上去，或在 GitHub 网页 Add file → Upload files 直接拖进去

第 2 步：开启 Pages

1. 仓库 Settings → 左侧 Code, planning, and automation 区块里的 Pages
2. Build and deployment → Source 选 Deploy from a branch
3. Branch 选 main，文件夹选 / (root) 或 /docs，按 Save

第 3 步：等上线

• 通常几分钟内完成，GitHub 说明最多可能要 10 分钟
• 回到 Settings → Pages，上方会显示 Your site is live at … 和网址
• 仓库的 Actions 分页可以看到部署进度；超过一小时还没更新，多半是构建出错，去那里看错误讯息

之后每次 push 到 main，网站都会自动重新发布。

flowchart LR
    subgraph A["本地"]
        A1["改 index.html"]
    end
    subgraph B["GitHub"]
        B1["push 到 main"]
        B2["Pages 自动构建"]
    end
    subgraph C["访客"]
        C1["用户名.github.io"]
    end
    A --> B1 --> B2 --> C

绑定自己的域名

在 GitHub：

1. Settings → Pages → Custom domain 填 www.aidentan.com，按 Save
2. DNS 生效后，勾选 Enforce HTTPS（证书签发需要时间，GitHub 说明最久可能要 24 小时才能勾）

在域名商 / Cloudflare 的 DNS：

• 只想用 www 子域名：设 CNAME 就好；想让不带 www 的主域名也能开：再加那四条 A 记录
• 📌 GitHub 建议先验证域名再绑定：个人账号 Settings → Pages → Add a domain，照指示加一条 TXT 记录，防止别人把你的域名接到他们的 Pages 上（takeover）
• 用 Cloudflare 管 DNS 的话，一开始可以先把这几条记录设为灰色云朵（DNS only），让 GitHub 顺利签发证书

⚠️ IP 地址以 GitHub Docs「Managing a custom domain」页面为准，设定前再核对一次。

适合 / 不适合

学完你会

• ✅ 分得清个人网站和项目网站的仓库命名与网址
• ✅ 用 Deploy from a branch 发布静态网站
• ✅ 绑定自己的域名并开启 HTTPS
• ✅ 知道 GitHub Pages 的限制和禁止用途

常见错误

• ❌ 首页文件叫 home.html 或 Index.html：打开网址是 404，首页要叫 index.html（全小写）。
• ❌ 免费账号把仓库设成 Private，找不到 Pages 选项：免费版只支持 Public 仓库。
• ❌ 想把 WordPress 放上 GitHub Pages：不支持 PHP 和数据库，要用正式主机。
• ❌ 图片或 CSS 在项目网站上全部失效：路径写成 /css/style.css（从网域根目录找），项目网站网址多了一层 /portfolio/，要改用相对路径 css/style.css。
• ❌ DNS 刚改完马上勾 Enforce HTTPS：证书还没签发，最久可能要等 24 小时。

Sources

官方文档：

1. What is GitHub Pages? - GitHub Docs
2. Creating a GitHub Pages site - GitHub Docs
3. Configuring a publishing source for your GitHub Pages site - GitHub Docs
4. GitHub Pages limits - GitHub Docs
5. Managing a custom domain for your GitHub Pages site - GitHub Docs
6. Verifying your custom domain for GitHub Pages - GitHub Docs