核心规则:域名使用限制
自定义域名同一时间只能用于主站或项目网站之一,不能同时使用。为其中一类配置域名,会导致另一类的自定义域名失效。请务必提前规划。
功能概览
此功能利用 GitHub Pages 服务,将您的公开仓库一键发布为可公开访问的静态网站。它分为两个管理面板:
- 官方配置: 在此管理所有公开仓库的发布状态。您可以将任何仓库发布为项目网站,或将特定仓库设为您的个人主站。发布的网站将通过 GitHub 官方域名 (
*.github.io) 访问。
- 自定义域名: 在此为您已经发布的网站绑定您自己的域名,让访问更专业、更便捷。
操作流程
- 发布为主站: 在“官方配置”面板中,找到您想作为主站的仓库,点击“发布为主站”按钮。程序会自动将其重命名为
您的用户名.github.io 并发布。
- 发布为项目: 对于其他公开仓库,点击“发布项目”按钮,即可将其发布。
- 配置自定义域名: 切换到“自定义域名”面板,找到已发布的网站,点击“配置域名”并按提示操作。
- 复制链接: 在任一面板中,直接点击已发布的仓库条目,即可快速复制其对应的访问链接。
自定义域名配置指南
要成功绑定您的域名,通常需要以下两个步骤:
第 1 步:在您的域名提供商处添加解析记录
- 记录类型: 选择
CNAME
- 主机记录: 填入您想使用的前缀,例如
www 或 blog。
- 记录值 (指向): 填入您的 GitHub Pages 主站地址,格式为
您的用户名.github.io。
第 2 步 (必须):将您的域名添加到 Cloudflare
为确保您的网站在中国大陆地区能被稳定访问并自动启用 HTTPS,强烈建议将您的域名添加到免费的 Cloudflare 服务中。
- 配置地址:
https://dash.cloudflare.com
- 操作建议: 登录后,直接添加您的顶级域名(例如
baidu.com),Cloudflare 会自动引导您完成后续设置。
重要提示
- 仓库要求: 只有公开 (Public) 仓库才能被发布为网站。
- 主站唯一性: 一个 GitHub 账号只能拥有一个主站,其仓库名必须严格遵守
用户名.github.io 的格式。
- 取消发布: 对于项目网站,此操作会禁用其 GitHub Pages 功能;对于主站,为安全起见,程序会将其重命名为一个备份名称来使其下线,您的文件不会丢失。
- CNAME 文件: 成功配置自定义域名后,系统会在您的仓库根目录下创建一个名为
CNAME 的文件,请不要手动删除或修改它。