Hexo博客部署-使用github作为保存中转仓库

本篇是在VPS上搭建Hexo静态博客的第一篇博文，写本篇的目的一是纪念一下，二是作为一个部署文档保留。

博客地址

相关描述

VPS环境是在搬瓦工上安装的centos6（x86），1核，512MB，10GB，1000GB/月的配置（$19.99/年，可用支付宝支付），主要的功能是搭个梯子，只做梯子好像有点浪费，于是买了个域名，搭建了这个博客。

Hexo好早之前有听说了，尤其喜欢next主题，简洁大方，考虑到VPS环境的不稳定问题，所以使用github作为博文的中转及保存的仓库，利用github的webhooks，当有push操作时直接发送请求，VPS监听该请求并执行更新操作，这样即使VPS环境挂了，博文信息还在github上，重新部署一遍就可以了。

具体过程

主要的步骤有：Hexo本地环境搭建、github仓库创建、webhooks创建、VPS服务器Hexo下载安装、VPS监听和更新脚本。

Hexo本地环境搭建

关于Hexo本地环境搭建比较简单，直接参考Hexo,这里只做简单的记录：

npm install -g hexo-cli

hexo init hexoblog

cd hexoblog

npm install

# 新增文章
hexo new <title> 

# 生成静态文件
hexo generate

# 简写
hexo g

# 启动服务，查看博文
hexo server

有关Hexo主题，本人比较喜欢next，最近好像有点样式的调整，不是特别喜欢，所以使用的还是原有的旧版。

github仓库创建

github远程仓库创建so easy，直接进入github仓库tab页面，点击创建即可。为了提交本地hexo相关文件的方便，我在github上配置了本地环境的ssh公匙信息，以达到不用输入用户名密码即可使用git命令将更改的文件提交到github相关仓库上。

具体配置过程

首先在本地环境配置生成秘钥文件，使用git的命令客户端

# 检查本地环境是否已有生成的密匙信息
cd ~/.ssh
# 如果没有.ssh目录文件，执行下面命令，直接一路回车
ssh-keygen -t rsa

生成如下结构

.
├── id_rsa
├── id_rsa.pub
└── known_hosts

直接拷贝id_rsa.pub里面的内容，并在github-setting-SSH and GPG keys中创建SSH key，粘贴内容到Key中，title可不填，保存后title直接显示所添加主机的主机名。

webhooks创建

钩子的创建在github上配置非常简单，进入到仓库页面，点击Settings-Webhooks，直接Add webhooks，这里只选择监听push事件，push事件发生后github将发送请求到VPS监听的URL（http://host:监听端口/webhooks/push/123 ） 上，VPS负责相关的更新操作。

VPS服务器安装Hexo

与本地安装一样，执行

npm install -g hexo-cli

即可（当然首先需要安装nodejs环境）

VPS监听

最近一直研究Nodejs，所以在VPS上使用Nodejs启动监听服务，非常简单：

// hexowebhooks.js

var http = require('http')
var exec = require('child_process').exec

http.createServer(function (req, res) {
    if(req.url === '/webhooks/push/123'){
        exec('sh ./deploy.sh');
    }
    res.end()
}).listen(监听端口)

其中，deploy.sh为更新脚本，用于更新VPS静态博文，将监听端口更换成你要监听端口即可。这里使用pm2管理监听服务。

运行

pm2 start hexowebhooks.js

更新脚本

更新脚本使用shell脚本，主要步骤是：

• 清除静态文件
• 删除db.json文件（不然pull github代码有冲突）
• 拉github上的代码
• 生成静态文件

在执行shell之前，需要先将github仓库代码pull下来，设置远程仓库信息

git clone https://github.com/tonny0812/hexoblog.git
或者
git clone git@github.com:tonny0812/hexoblog.git

cd hexoblog

git remote add hexo "git@github.com:tonny0812/hexoblog.git"

其中，hexo是远程仓库地址的别名。

更新脚本：

// deploy.sh

hexo clean
rm -f ./db.json
git pull hexo master
hexo g

然后访问博客网址即可，这里使用nginx反向代理，将静态网页内容映射到80端口上，由于VPS在美国，所以不需要备案即可访问80端口，国内的VPS（如阿里云）需要备案，查到使用HTTPS监听443端口不需要备案可以使用，还没有去折腾。

总结

这里的关键是使用了github的webhooks钩子机制，可以利用github这种免费的git数据仓库保存文章信息，VPS直接拉github上的代码，然后执行更新脚本，发布文章，由于使用nginx做代理，所以直接执行完更新脚本之后就可以直接访问新写的文章了。