本文地址：https://www.jeddd.com/article/github-pages-with-domain.html

网上许多关于 GitHub Pages 的教程文章由于年代久远，内容早已不再适用。我觉得也有必要写一篇文章来介绍如何以正确的姿势创建 GitHub Pages 仓库，并绑定自定义域名。

需要提醒的是，GitHub Pages 不是诸如 VPS 的服务器，它仅支持静态网页而不支持 PHP 等服务器后端语言。

在开始之前，你需要：

1. 拥有 GitHub 账号；
2. 拥有一个域名；
3. 在本地安装并配置好 Git。

建立 GitHub Pages

一、创建 GitHub 仓库

打开 GitHub 页面，点击【New repository】创建一个新的仓库。仓库名称必须是“<用户名>.github.io”，其中用户名必须严格匹配你 GitHub 账号的用户名。其它设置保持默认即可。

二、用 Git 创建第一个页面

1.在本机运行 Git Bash，然后切换到一个目录。待会要把仓库克隆到这个目录。

2.执行以下命令。注意替换成你的 GitHub 用户名：

$ git clone https://github.com/<用户名>/<用户名>.github.io

3.可以开始创建第一个网页文件了。执行以下命令：

$ cd <用户名>.github.io
$ echo 'It works!' > index.html

4.推送到 GitHub 仓库。

$ git add .    # 不要漏掉最后这个英文句点
$ git commit -m "Initialization"
$ git push -u origin master

第 3、4 步要执行的命令在下图中用红色箭头标注出来了：

检验你的 Pages

访问 https://<用户名>.github.io，应该已经可以打开网页了！

绑定自定义域名

网上很多教程叫你创建 CNAME 文件，现在已经不需要再用这种方式了。请跟随以下教程。

修改 Pages 设置

1. 进入你创建的 <用户名>.github.io 仓库，进入【Settings】。

1. 向下翻，找到设置中的“GitHub Pages”一栏，将自定义域名填入“Custom domain”选项。

提示：若未填写协议头，则默认为 HTTP。当然你也可以填写 HTTPS 域名。

修改域名 DNS

有些教程要求修改好几个 DNS 记录，那是不正确的。实际上只需要添加 1 个 CNAME 记录就够了。

为域名添加一个 CNAME 解析，记录值填写“<用户名>.github.io”。

访问新域名，成功！

如果无法访问，请耐心等待，直到 DNS 生效。

提示：Chrome 从 68 版本开始，所有 HTTP 网站会被标记为不安全。如果有能力申请证书，建议启用 HTTPS。

本文地址：https://www.jeddd.com/article/github-pages-with-domain.html