这是什么
GitHub Pages 是 GitHub 自带的静态站发布服务:仓库里放好 HTML(或用 Jekyll 等生成器),就能发布成网站。官方文档口径:GitHub Free 账号可以对公开仓库使用 Pages,免费。本站 2026-11-16 实测:在仓库里开启 Pages(main 分支、根目录)后站点正常上线,默认地址是「用户名.github.io」形式(项目站再带仓库名路径),强制 HTTPS 可以勾选。文档站、项目主页、个人博客这类纯静态内容,放这里是零成本且长期稳定的选择。
怎么申请
- 准备:注册 GitHub 账号(Free 即可),建一个公开仓库,里面放好静态文件——至少要有一个 index.html,或者一个 README 也能先跑起来。私有仓库不在免费口径内,别在私有仓库上折腾半天。
- 开启 Pages:进仓库 → 顶部 Settings → 左侧菜单点 Pages → Build and deployment 一节里,Source 选「Deploy from a branch」,分支选 main、目录选 /(root),点保存。本站实测就是这个位置、这个选法。时长:点保存几秒钟就好。卡点:找不到 Pages 入口,多半是停在了仓库主页——它在 Settings 里,不在主页的设置齿轮里。
- 等构建完成:保存后等一两分钟,Pages 设置页顶部会给出站点地址。⚠️ 刚保存就点开访问,很可能看到 404——那是构建还没跑完,不是你配错了(本站实测遇到过)。等构建完成再刷新就正常。卡点:等了十几分钟还是 404,去仓库的 Actions 页看 Pages 的构建记录有没有报错。
- 可选设置:在同一页勾选 Enforce HTTPS(强制 HTTPS);要绑自定义域名,也在这一页填域名,再按页面提示去域名商那边做 DNS 验证,两边都配好才生效。
拿到后怎么用
- 更新内容就是往仓库推提交:push 之后 Pages 自动重新构建发布,不用手动点部署。写文档、改页面,推上去等一两分钟就更新。
- 适合纯静态内容:文档站、项目主页、个人博客、落地页。没有服务器端运行时,留言、表单、搜索这类动态功能要接第三方服务或在前端调外部 API。
- 仓库是公开的,等于站点源文件人人可见:只放能公开的东西,密钥、私稿、未发布的稿件不要进 Pages 仓库。
额度
| 项目 | 内容 |
|---|---|
| 费用 | Pages 本身免费,面向 GitHub Free 账号的公开仓库(官方文档) |
| 默认地址 | 用户名.github.io(项目站为 用户名.github.io/仓库名) |
| HTTPS | 可勾选强制 HTTPS(本站实测) |
| 领取条件 | GitHub 账号、仓库公开、不绑卡 |
仓库与站点的大小、流量等细则以 GitHub 官方文档为准。
限制
- 免费的前提是仓库公开,代码和内容别人都能看。
- 只适合静态站:没有服务端运行时,动态功能要靠前端调用外部 API。
- 不适合拿来做大文件分发或高流量下载站,用途限制以官方文档为准。
容易卡住的地方
- 保存后访问是 404:先别改设置。刚开启时构建未完成就会这样(本站实测),等几分钟刷新;超过十几分钟还不行,去仓库 Actions 页看 Pages 构建是否失败,按报错改。
- 找不到 Pages 设置:路径是仓库 → Settings → 左侧 Pages。注意要在仓库自己的 Settings 里,不在账号的全局 Settings 里。
- 地址记错打不开:用户站是「用户名.github.io」,项目站是「用户名.github.io/仓库名」,少写仓库名就是 404。
- 自定义域名迟迟不生效:只在域名商那边指个 CNAME 不算完,Pages 设置页里的域名填写和 DNS 验证都要走完,页面提示验证通过才算数。
- 私有仓库开不了 Pages:免费口径只覆盖公开仓库,私有仓库发布属于付费计划范围。
避坑
- 公开仓库等于公开一切:别把带密钥的配置文件、未发布的稿子放进 Pages 仓库。
- 自定义域名要做 DNS 验证,按官方文档走,别只指个 CNAME 就以为完事。
- 更新站点只管往仓库推就行,别在服务器、FTP 这些方向上找入口——Pages 没有那种东西。
以上信息以官方页面为准,申请前请打开官网再核对一次。
常见问题
GitHub Pages 免费吗?
免费,GitHub Free 账号对公开仓库可用(官方文档),本站实测开启后站点正常上线。
GitHub Pages 在哪开启?
进仓库 → Settings → 左侧 Pages → Source 选 Deploy from a branch,分支选 main、目录选根目录,保存即可。
GitHub Pages 保存后打开是 404 怎么办?
多半是构建还没完成,等几分钟再刷新(本站实测构建完成后即正常)。长时间不行就去仓库 Actions 页看 Pages 构建报错。
GitHub Pages 的默认域名是什么?
用户名.github.io;某个仓库的项目站是 用户名.github.io/仓库名。
GitHub Pages 能放私有仓库吗?
免费口径是公开仓库;私有仓库发布属于付费计划范围,以官方文档为准。
GitHub Pages 能跑后端吗?
不能,它只发静态站,动态功能要调外部 API。
GitHub Pages 能绑自定义域名、用 HTTPS 吗?
可以。在 Pages 设置页添加自定义域名并完成 DNS 验证;强制 HTTPS 在同一页勾选开启。