添加 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 记录。
• 如果你的自定义域是一个顶端域名，配置一个 ALIAS , ANAME ,或者 A 记录。

真实的 CNAME 文件例子

atmos.github.io repository 有一个域名为 www.atmos.org 的 CNAME 文件。

• 用户 Pages 站点 atmos.github.io 定向到 www.atmos.org。
• 项目 Pages 站点 atmos.github.io/warden-github 定向到 www.atmos.org。

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

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

• 项目 Pages 站点 muan.github.io/emoji 定向到 muan.co/emoji，这对于 emoji.muan.co 也同样适用。

进一步了解

• “在 GitHub 页面上设置一个自定义域”