快速搭建Hexo博客+webhook自动部署+全站HTTPS

本文档主要用来记录自己借助Hexo搭建博客的一些步骤和命令，方便以后重装；新人也可以通过此篇文章快速搭建自己的个人博客。
下文的环境为:
VPS： CentOS6.9
本地： MacOS

还没有购买VPS，或者不知道怎么购买的请看我之前写的文章传送门

搭建博客

1、安装 NodeJS 和 NPM

[root@California_VPS ~]# curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -

执行完这个命令之后就可以安装NodeJS

[root@California_VPS ~]# yum install -y nodejs

这里安装的是8.X版本，如果安装其他版本将setup_8.x中的8改成对应的版本就可以了。
安装完成之后执行命令检查安装结果：

[root@California_VPS ~]# node -v
v8.8.1
[root@California_VPS ~]# npm -v
5.4.2

转载请注明出处：来自LeonLei的博客http://www.gaoshilei.com

2、安装 Nginx

通过 yum方式安装比较麻烦，还需要安装epel依赖库，下面介绍一种最简单的安装方法

[root@California_VPS ~]# vim /etc/yum.repos.d/nginx.repo

先在 yum.repos.d 文件下新建一个nginx.repo，然后将下面的内容拷贝进去，:wq保存退出

[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=0
enabled=1

执行下面的命令直接从配置文件安装 nginx

[root@California_VPS ~]# yum install nginx -y

然后打开服务器所在的IP测试nginx是否安装完成。

3、安装 Hexo

按照官网的文档执行命令

[root@California_VPS ~]# npm install -g hexo-cli

顺利的话一会就安装好了，有时候会遇到 npm 权限问题

/usr/bin/hexo -> /usr/lib/node_modules/hexo-cli/bin/hexo
hexo-util@0.6.1 postinstall /usr/lib/node_modules/hexo-cli/node_modules/hexo-util
npm run build:highlight
hexo-util@0.6.1 build:highlight /usr/lib/node_modules/hexo-cli/node_modules/hexo-util
node scripts/build_highlight_alias.js > highlight_alias.json
sh: highlight_alias.json: 权限不够
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! hexo-util@0.6.1 build:highlight: node scripts/build_highlight_alias.js > highlight_alias.json
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the hexo-util@0.6.1 build:highlight script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

这个时候需要开启 npm 的 unsafe-perm 模式

[root@California_VPS ~]# npm config set unsafe-perm "true"

查看是否设置成功

[root@California_VPS ~]# npm config get unsafe-perm
true

如果为 true 则设置成功，再次执行 hexo 的安装命令即可顺利安装成功。

因为需要把之前在 github 的博客备份重新拷贝新的服务器上，所以要配置 ssh 公钥方便 git 操作。

先生成公钥

[root@California_VPS ~]# ssh-keygen -t rsa -b 4096 -C "xxxxx@xxx.com"

这一步会生成ssh公钥，也就是 public key，生成之后可以通过下面的命令查看

ls -al ~/.ssh

如果有 id_rsa id_rsa.pub 证明生成成功，然后通过下面的命令查看 ssh 公钥

cat ~/.ssh/id_rsa.pub

再将这个公钥拷贝到 github 的账户配置中即可。

注意： 为了方便在本地修改博客、实时预览、自动部署，以上（除了Nginx安装）所有步骤在本地机器上也需要重新操作一遍，以后在本地直接修改之后推送github，配合下文的webhook，服务器会自动更新

4、配置博客

新安装：参照 Hexo官方教程
重装：从 github 上把之前的博客 clone 下来，放到 root 目录下：

git clone git@github.com:gaoshilei/hexo-blog.git

然后配置 nginx，让 80 端口指向博客静态页面首页，在 nginx 配置文件目中新建一个hexo.conf文件

[root@California_VPS ~]# vim /etc/nginx/conf.d/hexo.conf

写入相应的配置

server {
    listen          80;
    server_name     gaoshilei.com www.gaoshilei.com;
    location / {
        root        /root/hexo-blog/public;
        index       index.html;
    }
}

重启 nginx 使服务生效

[root@California_VPS ~]# nginx -s reload

此时去访问 IP 得到的是一个 404 报错，因为 nginx 是以 nginx 用户运行的，他没有博客目录的读写权限，有两个方法可以解决：

  1. 给博客目录赋权，让 nginx 用户拥有读写权限
  2. 让 nginx 以 root 用户运行

我采用第二种方式，修改 nginx 的配置文件

[root@California_VPS ~]# vim /etc/nginx/nginx.conf

将 user nginx; 改成 user root; 即可。然后重启 nginx。

再去访问发现 404 没了，但是页面是一片空白，找了半天原因，之前用到的主题并没有上传到 github 上，将主题拷贝到 themes 文件夹下，然后部署 hexo 就可以正常访问了。

hexo 常用的命令
生成静态文件并部署网站:

安装 hexo 服务（本地可以通过这个服务实现预览，不需要安装nginx）

# npm install hexo-server --save

启动 hexo 服务，默认端口为 4000

# hexo server

用指定端口(port)启动启动 hexo 服务

# hexo server -p port

生成静态文件

# hexo g

清除缓存文件 (db.json) 和已生成的静态文件 (public)

# hexo clean

生成站点map

# npm install hexo-generator-sitemap --save
# npm install hexo-generator-baidu-sitemap --save

配置 webhooks 自动更新博客

每次在本地更新了博客，push 到 github 上，还要去 VPS 再 git pull 一下，确实很麻烦，配置好 webhooks 就可以在 github 有 push 操作时自动更新并部署博客。

webhooks 在 github 对应仓库直接设置就行，重点是服务器的接收和相应的操作。
有 Python、PHP、NodeJS 多种方式可以接收 webhooks , 由于 hexo 是基于 NodeJS 的，所以这里用 NodeJS 来接收 github 的 push 事件。

安装依赖库 github-webhook-handler：

[root@California_VPS ~]# npm install -g github-webhook-handler

安装完成之后配置 webhooks.js

[root@California_VPS hexo-blog]# vim webhooks.js

然后将下面代码的拷贝进去

var http = require('http')
var createHandler = require('github-webhook-handler')
var handler = createHandler({ path: '/webhooks_push', secret: 'leonlei1226' })
// 上面的 secret 保持和 GitHub 后台设置的一致

function run_cmd(cmd, args, callback) {
  var spawn = require('child_process').spawn;
  var child = spawn(cmd, args);
  var resp = "";

  child.stdout.on('data', function(buffer) { resp += buffer.toString(); });
  child.stdout.on('end', function() { callback (resp) });
}

http.createServer(function (req, res) {
  handler(req, res, function (err) {
    res.statusCode = 404
    res.end('no such location')
  })
}).listen(6666)

handler.on('error', function (err) {
  console.error('Error:', err.message)
})

handler.on('push', function (event) {
  console.log('Received a push event for %s to %s',
    event.payload.repository.name,
    event.payload.ref);
    run_cmd('sh', ['./deploy.sh'], function(text){ console.log(text) });
})

其中 secret 要和 github 仓库中 webhooks 设置的一致，6666 是监听端口可以随便改，不要冲突就行，./deploy.sh 是接收到 push 事件时需要执行的shell脚本，与 webhooks.js 都存放在博客目录下；path: '/webhooks_push 是 github 通知服务器的地址，完整的地址是这样的http://www.gaoshilei.com:6666/webhooks_push

用 https 会报错，github 设置页面会 deliver error，所以把地址改成了 http

配置./deploy.sh

[root@California_VPS hexo-blog]# vim deploy.sh

将下面代码拷贝进去

git pull origin master
hexo g

然后运行

[root@California_VPS hexo-blog]# node webhooks.js

就可以实现本地更新 push 到 github ，服务器会自动更新部署博客。
最后要将进程加入守护，通过 pm2 来实现

[root@California_VPS ~]# npm install pm2 --global

然后通过 pm2 启动 webhooks.js

[root@California_VPS hexo-blog]# pm2 start webhooks.js 
[PM2] Starting /root/hexo-blog/webhooks.js in fork_mode (1 instance)
[PM2] Done.
┌──────────┬────┬──────┬───────┬────────┬─────────┬────────┬─────┬───────────┬──────┬──────────┐
│ App name │ id │ mode │ pid   │ status │ restart │ uptime │ cpu │ mem       │ user │ watching │
├──────────┼────┼──────┼───────┼────────┼─────────┼────────┼─────┼───────────┼──────┼──────────┤
│ webhooks │ 0  │ fork │ 10010 │ online │ 0       │ 0s     │ 14% │ 24.2 MB   │ root │ disabled │
└──────────┴────┴──────┴───────┴────────┴─────────┴────────┴─────┴───────────┴──────┴──────────┘
 Use `pm2 show <id|name>` to get more details about an app

全站 HTTPS

使用 Let’s Encrypt 的免费证书，不过每三个月要续签一次，安装可以通过 Certbot 的傻瓜式操作

[root@California_VPS www]# wget https://dl.eff.org/certbot-auto
[root@California_VPS www]# chmod a+x certbot-auto

下载脚本，然后赋权

[root@California_VPS www]# sudo ./certbot-auto --nginx

执行脚本，获取证书，Certbot 会自动帮我们配置 nginx 的一些配置。走到最后可能遇到这种情况

Cannot find a VirtualHost matching domain www.gaoshilei.com. In order for Certbot to correctly perform the challenge please add a corresponding server_name directive to your nginx configuration: https://nginx.org/en/docs/http/server_names.html

之前在配置 nginx.conf 文件的时候忘记加域名了，把 server_name 补全就行了，然后重新执行一次脚本，顺利申请了证书，而且 Certbot 都帮我配置好了，nice！
不过这个证书有效期只有三个月，所以需要续签，可以手动续签，证书快过期的时候执行

# sudo /root/www/certbot-auto renew

或者将上面的命令加入 crontab 定时任务

[root@California_VPS etc]# ps -ef | grep cron
root      1164     1  0 Oct30 ?        00:00:00 crond
root      8507  8222  0 07:31 pts/0    00:00:00 grep cron  
[root@California_VPS etc]# service crond status
crond (pid  1164) is running...

先检查一下有没有安装 crontab，并且查看 crontab 的运行状态。最后配置

[root@California_VPS etc]# crontab -e

添加下面这条命令到配置文件中

0 0 * * 0 /root/www/certbot-auto renew

这条命令的意思是每周日的0点0分执行/root/www/certbot-auto renew这条命令。执行下面这条命令查看定时任务列表中是否有刚才添加的任务

[root@California_VPS etc]# crontab -l 
0 0 * * 0 /root/www/certbot-auto renew

大功告成！

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 203,937评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,503评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 150,712评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,668评论 1赞 276
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,677评论 5赞 366
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,601评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,975评论 3赞 396
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,637评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,881评论 1赞 298
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,621评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,710评论 1赞 329
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,387评论 4赞 319
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,971评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,947评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,189评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 44,805评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,449评论 2赞 342

推荐阅读更多精彩内容