Re:从零开始的Hexo搭建个人博客

Posted 2020-11-01 yulinlewis

本章讲的是如何将本地的个人项目远程部署到 GitHub Pages，涉及到GitHub的项目仓库、Git的使用，以及Hexo的远程部署等。

1. 安装 hexo-deployer-git 插件

想要将Hexo项目部署到 GitHub上，需要先安装一个插件。在Hexo项目的根目录打开命令窗口，输入：

npm install hexo-deployer-git --save

2. GitHub上创建一个仓库

仓库的名字可以随便起，不过这个仓库是作为我们的博客仓库的，所以尽量将名字以 {username}.github.io 的形式来起。

比如，我的GitHub用户名是lewky，我就会把这个仓库命名为lewky.github.io。（为什么要这样起名，后面会说明）

3. 修改本地的项目配置文件

在 _config.yml 找到如下：

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type:

把刚刚我们新建的GitHub仓库链接配置进来：

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: [email protected]:/{user}/{repository}.git
  branch: master
  message:

请注意，这里的仓库地址如果写成：https://github.com/{user}/{repository}.git可能会在后边的部署时无法成功，需要将https://github.com改成[email protected]:。

另外这里的branch和message可以不填，branch会默认是master分支，message会默认用下边的格式模板：

Site updated: {{ now(‘YYYY-MM-DD HH:mm:ss‘) }}

4. SSH key的创建与配置

最关键的一步来了，我们需要生成一对密钥对，然后将公钥配置到GitHub账号上。

4.1 生成RSA密钥对

首先使用 Git Bash 输入：

cd ~/.ssh

~ 指的是当前用户的根目录，即 C:\Users\{user}\；而 .ssh 目录下一般存放着公开的SSH key文件：

• id_dsa.pub
• id_ecdsa.pub
• id_ed25519.pub
• id_rsa.pub

此外还有个 known_hosts 文件，SSH会把我们每个访问过的计算机的公钥(public key)都记录在里面。

如果在使用了 cd ~/.ssh 后能找到路径，那就把该目录下的 id_rsa.pub 文件里的内容复制到剪切板。如果找不到路径，就执行命令：

ssh-keygen -t rsa -b 4096 -C "[email protected]"

该命令会生成新的SSH key，这里的参数含义：

-t: type，生成的密钥类型
-b: bits，指定密钥长度，对于RSA密钥，最小要求768位，默认是2048位。DSA密钥必须恰好是1024位，一般越长越安全。
-C: comment，提供一个新注释

接着会看到如下提示：

Enter file in which to save the key (/c/Users/123/.ssh/id_rsa):

这里按下回车，表示将SSH key保存到默认地址，即：C:\Users\{user}\

如果本身已经存在一个RSA私钥了，会提示你：

/c/Users/123/.ssh/id_rsa already exists.
Overwrite (y/n)?

这里输入 y 可以重新生成RSA密钥对；然后就会看到如下提示：

Enter passphrase (empty for no passphrase):

这里按下回车，表示不设置密码；接着会再提示你输入重复密码，依然是按下回车。

Enter same passphrase again:

这时候我们的SSH key就生成好了，去 ~/.ssh 目录下将里边的 id_rsa.pub 文件里的内容复制到剪切板。

4.2 在 GitHub 上配置SSH key

接着登陆我们的 GitHub 账号：

• 进入 Settings 页面
• 选择 SSH and GPG keys
• 点击 New SSH key
• 填写 Title（用来给公钥起一个名字，以便和其他的公钥区分开来）
• 然后在 Key 里将我们刚刚复制的公钥复制进去
• 最后点击 Add SSH key，这时候 GitHub 会要你输入账号密码进行确认。

4.3 验证ssh连接

使用 Git Bash 输入：

ssh -T [email protected]

接着会看到：

The authenticity of host ‘github.com (192.30.253.112)‘ can‘t be established.
RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8.
Are you sure you want to continue connecting (yes/no)?

输入 yes，会看到：

Warning: Permanently added ‘github.com,192.30.253.112‘ (RSA) to the list of known hosts.
Hi lewky! You‘ve successfully authenticated, but GitHub does not provide shell access.

这时候 github.com的公钥被保存到known_hosts文件里，如果我们再执行一次ssh -T [email protected]，就不需要输入yes了，会直接看到：

Hi lewky! You‘ve successfully authenticated, but GitHub does not provide shell access.

4.4 部署到 GitHub Pages

输入命令：

hexo d
或者
hexo g -d

后一条命令表示生成静态页面并部署到远处仓库，第一次部署会久一点，部署成功后会看到：

 * [new branch]      HEAD -> master
INFO  Deploy done: git

接着登陆 GitHub 并进入我们的项目仓库，可以看到已经多出了很多文件，且其 message 都是默认的格式：

Site updated: {{ now(‘YYYY-MM-DD HH:mm:ss‘) }}

接下来点击 Settings 进入该仓库的设置页面，找到 Github Pages 这一项，选择以 Master 分支作为 source，然后保存；接下来这个仓库就会被部署到 https://{username}.github.io/{仓库名}。

如果你希望直接通过 https://{username}.github.io/ 来访问你的博客，可以将仓库名改为 {username}.github.io；这样就不需要在url后边添加上仓库名来访问了。

接下来，开始享受你的个人博客吧 :)