添加 CNAME 文件到你的存儲庫中

如果你正在使用一個自定義域名去重定向你的 GitHub Pages，你必須創(chuàng)建和提交一個包含自定義域名的 CNAME 文件到你的 GitHub Pages 存儲庫中。

1. 在 GitHub，導(dǎo)航到你的頁面存儲庫。
2. 在“分支”菜單中，切換到你存儲庫的Pages 分支：
   • 對于用戶和組織的頁面站點來說，Pages 分支是 master 。
   • 對于項目頁面站點來說，Pages 分支是 gh-pages 。
3. 添加一個新文件，命名為 CNAME （全部大寫！），放在 Pages 分支的根目錄下。
4. 在新文件中，添加一行，指定自定義域名的空子域名。例如，使用 blog.example.com 而不是 https://blog.example.com 。請注意，在 CNAME 文件中只允許有一個域名。
5. 輸入提交的消息，或接受默認消息。
6. 在提交消息的對話框底部，點擊 Confirm merge。

確認自定義域名配置正確

1. 在你的存儲庫右邊側(cè)邊欄，點擊http://wiki.jikexueyuan.com/project/github-pages-basics/images/cnamefile1.png" alt="" />.

2. 在“ GitHub Pages ”底部，你會看到你的 CNAME 文件的自定義域名。

http://wiki.jikexueyuan.com/project/github-pages-basics/images/cnamefile3.png" alt="" />

下一步：配置 DNS 的設(shè)置項

在你已經(jīng)創(chuàng)建和提交你的 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 頁面上設(shè)置一個自定義域”