如何用Hexo搭建个人博客

题图

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

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,你希望将其部署到你的服务器上,所以你需要一种方式将其自动部署到服务器上,这个过程是怎么实现的呢?我们可以通过如下方式完成:

  1. 在服务器端 clone 下来你的repo
  2. 在github上配置webhook,指向你的server
  3. 在server端监听webhook的事件
  4. 监听到事件之后自动运行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,然后自动推送到你个人的服务器上。

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

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

posted @ 2020-05-04 17:31  黑客悟理  阅读(110)  评论(0编辑  收藏