如何用Hexo搭建个人博客

2022-11-29 15:49:49

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

Hexo是如何工作的？

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

虽然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，然后自动推送到你个人的服务器上。

更多讨论请关注我的公众号: 黑客悟理

如果你喜欢我的文章，可以在任一平台搜索【黑客悟理】关注我，非常感谢！

码农公寓