---

一、 GitHub Pages 介绍

• 我们利用 Hexo 框架在本地搭建了一个精美的博客，可是只能本地访问，要想发布到互联网上，还需要将它部署在网站上

• 博客的功能只要能阅读文章就够了，因此可以考虑将其部署在提供静态网页托管服务的网站上，这样就省去了购买服务器(云主机)，购买域名这些步骤，不仅省钱省事

• 当前许多平台都提供了静态网页托管服务，其中最方便的当然是 GitHub Pages，只需要注册一个账号就可以使用

• GitHub Pages

二、GitHub Pages 准备

• 首先进入官网：GitHub，登录（这里需要一个账号，此处不再赘述，没有账号的根据要求提示注册一个账号即可）

• 点击右上角Sign in登录后，点击左上角New（或者右上角+）新建仓库

• 由于每个 GitHub 账户只能建立一个 GitHub Pages 页面，所以 Repository name 必须填 <你的用户名>.github.io ！！！否则就会建立一个普通仓库，GitHub Pages 功能不会生效

• 比如用户名是demo，Repository name 这里就填demo.github.io，不知道用户名是哪个，可以点击页面右上角头像，看到第一行“Signed in as xxx”字样， xxx即为这里的用户名

• Description 填写仓库描述，比如 blog等，可不填。注意勾选 Public ，否则 GitHub Pages 功能不会生效。建议勾选 Add a README file，会自动生成一个 readme.md文件。最后点击Create repository创建仓库

三、GitHub Pages 发布

3.1 配置

• 我们把自己的博客生成静态 html 网页，提交到这个仓库目录下，就可以在我们的网址看到博客页面了，这就是 Hexo 框架部署博客的原理。对于 Hexo 来说，提交部署只需要几条命令即可。
• 在博客根目录下，右键，打开Git Bash Here。配置用户名和邮箱，这两个参数用于 Git 提交时的身份识别：

# 其中 username 和 username@XXX.com 是你注册 GitHub 的用户名和邮箱
git config --global user.name "username"
git config --global user.email "username@XXX.com"
1
2
3

• 生成 SSH keys，主要用于Git 提交时的权限控制和加密，本地根据 RSA 算法生成公私密钥对，然后将公钥添加到 GitHub 上，本机就可以提交代码到自己的 GitHub 库了。这个是根据当前使用的电脑的一些信息生成的，所以换电脑提交时要重新生成并添加。输入下面命令，然后一直按回车，直到结束：

 # 其中 username@XXX.com 是你注册 GitHub 的邮箱
 ssh-keygen -t rsa -C "username@XXX.com"
1
2

• 输入下面的命令，查看公钥内容，应该是一个ssh-rsa开头，以你的邮箱结尾的长字符串：

# cat后面的路径就是上图中的公钥文件路径，直接复制过来就可以
cat /C/Users/XXX/.ssh/id_rsa.pub
1
2

• 复制公钥内容，打开自己的 Github 主页，点击右上角的头像，点击Settings。点击SSH and GPG keys，然后点击New SSH keys

• Title 可以随便起一个名字，Key 填写上一步复制的公钥内容，然后点击Add SSH key

• 最后执行下面的命令，测试一下 Git 参数是否配置成功。出现你的用户名和successfully字样，说明配置成功。

ssh -T git@github.com
1

3.2 安装插件

• 在博客根目录下，右键，打开Git Bash Here。输入下面的命令，安装hexo-deployer-git。这个插件用于把生成好的静态页面上传到 GitHub Pages 仓库。

npm install hexo-deployer-git
1

3.3 发布

• 打开博客根目录配置文件(D:\hexoblog\ _config.yaml)，拉到文件最后一行，修改为下面的配置（没有的配置项自行添加），保存：

# 其中 xxxxxx 是前面多次用到的你的GitHub用户名
deploy:
  type: git
  repo: git@github.com:xxxxxx/xxxxxx.github.io.git
  branch: main
1
2
3
4
5

• 执行下列命令：

# 注意最后变成d了，原来的s表示服务起在本地，现在的d表示部署在远端
hexo g && hexo d
1
2

• 待命令执行完毕，打开浏览器，输入网址https://你的用户名.github.io，可以看到一个本地部署的一模一样的博客出现了。https://你的用户名.github.io就是你的个人博客地址了，其他人都可以访问。

四、总结

• 至此，我们从0到1快速搭建一个博客的任务初步完成了。本篇文章介绍了利用 GitHub Pages 发布个人博客的方法，如果觉得 GitHub 访问速度太慢，也可以参考对照着基于 Gitee Pages 搭建国内博客站点。后续就是对文章发布，博客迁移，网站优化的内容了，创作不易，感谢三连~