返回首页 GitHub Pages 指南

添加 CNAME 文件到你的存储库中

如果你正在使用一个自定义域名去重定向你的 GitHub Pages,你必须创建和提交一个包含自定义域名的 CNAME 文件到你的 GitHub Pages 存储库中。

  1. 在 GitHub,导航到你的页面存储库。
  2. 在“分支”菜单中,切换到你存储库的Pages 分支
    • 对于用户和组织的页面站点来说,Pages 分支是 master
    • 对于项目页面站点来说,Pages 分支是 gh-pages
  3. 添加一个新文件,命名为 CNAME (全部大写!),放在 Pages 分支的根目录下。
  4. 在新文件中,添加一行,指定自定义域名的空子域名。例如,使用 blog.example.com 而不是 https://blog.example.com 。请注意,在 CNAME 文件中只允许有一个域名
  5. 输入提交的消息,或接受默认消息。
  6. 在提交消息的对话框底部,点击 Confirm merge

确认自定义域名配置正确

  1. 在你的存储库右边侧边栏,点击.

  2. 在“ GitHub Pages ”底部,你会看到你的 CNAME 文件的自定义域名。

下一步:配置 DNS 的设置项

在你已经创建和提交你的 CNAME 文件到 GitHub 之后,在你的 DNS 提供者上做以下项之一:

真实的 CNAME 文件例子

atmos.github.io repository 有一个域名为 www.atmos.orgCNAME 文件

注意项目 Pages 站点如何继承其所有者的用户 Pages 站点的域。

emoji repository有一个域名为 emoji.muan.coCNAME 文件。它归 muan 所有,muan 的用户 Pages 存储库有一个域名为 muan.coCNAME 文件

进一步了解