如何用Hexo搭建个人博客

以前用Wordpress搭建过一个博客网站，Wordpress虽然安装简单，功能强大，但是对于个人建站来说有点复杂了。最近发现用Hexo建站很流行，于是将网站从Wordpress迁移到了Hexo。

Hexo是如何工作的？

首先，Hexo是一个搭建静态网站的工具，所以Hexo生成的文章页面都是静态页面。根据我的总结，用Hexo发布一篇文章的大致流程如下：

graph TD;
    id1[本地写Markdown文章];
    id2[用Hexo g 生成网页];
    id3[用Hexo s 本地预览];
    id4[用Hexo d 部署到服务器];
    id1 --> id2;
    id2 --> id3;
    id3 --> id4;

虽然Hexo还有很多丰富强大的功能，但以上流程可以很好帮助我们大致理解Hexo这个工具，很明显它和Wordpress之类的建站工具不太一样，Hexo更多的事都是在“本地”操作的，因为生成的是静态页面，所以你网站所在的服务器只需要存储Hexo生成的结果即可。

Hexo + Github + 阿里云服务器

阿里云服务器+域名+hexo搭建个人博客

安装配置

请在你自己的电脑上安装好Node.js和Hexo（你在哪儿写Markdown就把Hexo安装到哪里）。Hexo的下载和安装可以直接参考官方文档，此处略过。如何配置Hexo以及用Hexo生成一篇文章也请参考官方文档，比较简单。

Hexo目录放到Github

建议将你的Hexo目录放到github上管理，可以在github上新建一个private的repo。Hexo生成目录的时候会自动包含一个.gitignore 文件，请保留这个文件。如何在Github创建repo并和本地同步，请单独搜索相关教程，比较常规。

网站目录托管到Github

注意，我们需要另外一个Git Repo来存放你的网站文件，这个和刚才的Hexo目录并不是一回事，同样我们需要在Github上新建一个repo，然后在本地的Hexo配置文件_config.yml中将配置修改成如下的样子。参考：https://hexo.io/zh-cn/docs/one-command-deployment.html

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@github.com:xxxxxxxx/blog.git
  branch: master

这样当你每次用Hexo生成好静态文件后，可以通过* hexo d *命令一键将你的网站上传到github。

自动部署到个人服务器

你的整个静态网站目前就是github上的一个repo，你希望将其部署到你的服务器上，所以你需要一种方式将其自动部署到服务器上，这个过程是怎么实现的呢？我们可以通过如下方式完成：

在服务器端 clone 下来你的repo
在github上配置webhook，指向你的server
在server端监听webhook的事件
监听到事件之后自动运行git pull

1. 在服务器端 clone 下来你的repo

这一步需要你在服务器端安装git，同时在github端加入你自己的SSH KEY，相当于在github上给服务器添加到白名单，这样每次服务器git pull 的时候才能顺利完成。clone 的时候一定要选择ssh方式，形如： git clone git@github.com/…

2. 在github上配置webhook，指向你的server

直接到你的repo的setting选项里面去找，按照提示操作。

3. 在server端监听webhook的事件

首先要在你个人的服务器上安装 webhook 插件，这一步必不可少：

npm install -g github-webhook-handler

然后在服务器新建 webhook.js 文件，名字你可以任意取，这个文件其实就是一个node服务，一会我们要运行它。

var http = require('http');
var spawn = require('child_process').spawn;
// 在我的服务器上使用相对路径会出错，所以下面用了绝对路径“ /usr/... 的格式
var createHandler = require('/usr/lib/node_modules/github-webhook-handler');

// 下面填写的myscrect跟github webhooks配置一样，下一步会说；path是我们访问的路径
var handler = createHandler({ path: '/hexo', secret: '你的密码，要和github上配置的一致' });
http.createServer(function (req, res) {
  handler(req, res, function (err) {
    res.statusCode = 404;
    res.end('no such location');
  })
}).listen(7777);
handler.on('error', function (err) {
  console.error('Error:', err.message)
});
// 监听到push事件的时候执行我们的自动化脚本
handler.on('push', function (event) {
  console.log('Received a push event for %s to %s',
    event.payload.repository.name,
    event.payload.ref);
  runCommand('sh', ["/path/to/deploy.sh"], function( txt ){
    console.log(txt);
  });
});
function runCommand( cmd, args, callback ){
    var child = spawn( cmd, args );
}

其中deploy.sh中的内容如下：

#!/bin/bash

cd /var/www/blog
git reset --hard origin/master
git clean -f
git pull origin master

然后，先用如下命令验证一下服务是否可以正常运行：

node webhook.js

没问题之后可以用pm2这个工具来重新运行服务（如果没有pm2请先用node安装它）

pm2 start webhook.js

大功告成，之后你每次用hexo d部署之后，你的文件都会上传到github，然后自动推送到你个人的服务器上。