Hexo 从零开始（2）Hexo部署到 GitHub Pages

1. 注册 GitHub

1.1 打开GitHub官网注册github账号: github.com/

1.2 新建username.github.io 个人仓库：

方法一：打开网站github.com/new，直接新建，**（**下方的Add a README file记得勾上）

方法二：在github首页单击头像->Your repositories 新建仓库，（下方的Add a README file记得勾上）

仓库名为什么要命名为username.github.io？

GitHub Pages有两种类型：User/Organization Pages 和 Project Pages，而我所使用的是 User Pages 。简单来说，User Pages 与 Project Pages 的区别是：
- User Pages 是用来展示用户的，而 Project Pages 是用来展示项目的
- 用于存放User Pages的仓库必须使用 username.github.io 的命名规则，而 Project Pages则没有特殊的要求
- User Pages通过https://username.github.io进行访问，而Projects Pages通过https://username.github.io/projectname进行访问
新建个人仓库图示

2. 配置GitHub连接密钥

2.1 设置用户名称和邮件地址

此处为全局配置，所以可以在任意位置打开**git bash**,

git config --global user.name "Github用户名"

git config --global user.email "Github邮箱"

2.2 创建 SSH 密钥

为了能够在本地使用git管理github上的项目，所以需要绑定SSHkey运行以下命令创建

ssh-keygen -t rsa -C "Github邮箱"

less ~/.ssh/id_rsa.pub

Untitled 1

2.3 添加 SSH 密钥

打开GitHub，点击右上角头像->Setting->左侧 SSH and GPG keysNew SSH key,点击下面书签直达也行

复制并填写SSH Key，随便取一个title ，保存即可

Untitled 3

2.4 验证SSH密钥连接

在git bash测试sshkey是否添加成功，运行如下命令，

**ssh -T git@Github.com**

图示

3. 配置hexo本地内容并进行部署

3.1 首先安装依赖

站点部署到github必须要配置Deployment依赖

npm install hexo-deployer-git --save

3.2 修改 `_config.yml` 配置文件

修改底部的deploy 项，2选一进行修改并保存

务必记得把username替换为自己的用户名，（2020年10月后github新建仓库默认分支改为main），注意修改

deploy:
  type: git
  repo:
    github:
      url: git@github.com:username/username.github.io.git
      branch: main

deploy:
  type: git
  repo:
    github: git@github.com:username/username.github.io.git,main

3.3 部署到Git仓库

输入下面Hexo3连命令，把本地hexo博客内容提交到git仓库

hexo clean && hexo generate && hexo deploy

hexo c && hexo g && hexo d

每次在本地推送完后，还要等待GitHub反应过来部署到他家的服务器上

网页部署阶段可能出现的bug

报错ERROR Deployer not found: git git用户名和邮箱配置错误，这里的%，在正确的格式中是一个空格，如果你之前没有打空格，那么邮箱和用户名根本就没有记录进去。回退到这一步重新进行
```
git config --global user.name%"username"
git config --global user.email%"username@example.com"
```
hexo-deployer-git插件没有安装正确，重新在[Blogroot]路径下右键->Git Bash Here，执行：
```
npm install hexo-deployer-git –save
# 重新安装之后，再尝试提交
hexo deploy
```

3.4 预览博客效果

浏览器访问https://yourname.github.io 即可看到博客内容

4. 配置自定义域名（可选）

4.1 购买域名

4.2 解析域名

为了能够使用自己的域名访问我们的博客，打开你的云服务器后台，进行域名解析

Untitled 5

4.2.1 添加`A`记录

值为你的服务器IP(ping useneme.github.io获取）

Untitled 7

4.2.2 添加`CNAME`记录

值为username.github.io ,全部指向你的GitHub Pages域名

4.3 绑定域名

在[Blogroot]\source\目录下新建CNAME文件（注意不要有后缀名，就叫CNAME即可，什么.txt、.js之类的后缀都不能有），在CNAME文件中添加上你购买的域名，【当你在本地hexo d的时候，Github上的CNAME就会消失】

打开你的Github仓库->Settings->Pges，在下方的Custom domain填上你的域名并保存

Untitled 8

4.4 访问博客

最后，重新部署一下hexo即可通过你的域名来访问博客了

hexo clean
hexo generate
hexo depoly

5. 安装 SSL 证书

没有安装SSL证书时，你的网站使用的是HTTP协议，连接没有加密，会显示为不安全 而安装了SSL证书之后，网站使用的就是HTTPS协议，连接会被加密，图标会变成一把锁

• 使用个人站点的话请移步『Linux』Nginx 配置 SSL 证书 •如果是Github Page的话，勾选下面的Enforce HTTPS 就可以了，GitHub过一会儿会给你弄好的

部署到个人站点或者Github Pages后，就可以在_config.yml中正大光明地写上你的网站地址了

Hexo 博客搭建教程（2）部署到 GitHub Pages