基于Node.js搭建hexo博客过程详解

2024-05-06 16:52:44

字体：大中小

来源：转载

供稿：网友

一、安装新版本的nodejs和npm

安装n模块：

npm install -g n

升级node.js到最新稳定版

n stable

二、安装hexo

note: 参考github，不要去其官网

安装Hexo

npm install hexo-cli -g

Setup your blog

hexo init blemeshcd blemesh

安装Cactus主题，众多开源主题中比较简洁的一个：

主题页

Cactus页

git clone https://github.com/probberechts/hexo-theme-cactus.git themes/cactus

修改主题配置：

vim _config.yml

# Extensions## Plugins: https://hexo.io/plugins/## Themes: https://hexo.io/themes/## theme: landscapetheme: cactustheme_config:colorscheme: white

Create pages and articles with the hexo new [layout] <title> command. For example, to create an "about me" page, run:

hexo new page about

This will create a new file in source/about/index.md Similary, you can create a new article with

hexo new post "hello world"

and add some interesting content in source/_posts/hello-world.md.

Start the server：

hexo server

8001 port：

hexo server -p 8001

三、安装hexo-admin并配置

安装：

npm install --save hexo-admin

打开目录下的_config.yml配置hexo-admin：

admin:

username: XXXX(自己设置用户名)password_hash: XXXXXXXXX(密码，但是是明文经过bcrypt hash加密后生成的)secret: hey hexo(用于cookie安全)deployCommand: './admin_script/hexo-generate.sh'(调用该脚本）

注：

1）其中password_hash是你自己的明文密码经过加密后的字符串，但是如果用类似下面的网址： https://bcrypt-generator.com/ 会生成:$2y$10$pJjIxxxxxfMn9U/xxxxxNuuA20kh1eoB7vZxxxxx/7WpeV7IOxxxx类似的加密串，但是运行会报invalid salt revision错误，其原因是：

➜ blemesh cat node_modules/hexo-admin/www/bundle.js | head -4851 | tail -10if (salt.charAt(0) != '$' || salt.charAt(1) != '2')throw "Invalid salt version";if (salt.charAt(2) == '$')off = 3;else {minor = salt.charAt(2);if (minor != 'a' || salt.charAt(3) != '$')throw "Invalid salt revision";off = 4;}

需要版本号是2a的加密方式，因此只能用python自己写了：

https://pypi.org/project/bcrypt/3.1.0/

>>> hashed = bcrypt.hashpw(password, bcrypt.gensalt(prefix=b"2a"))>>> print(hashed)b'$2a$12$PAoJr3USOBxxxxxxxxxxxxxxV/.h.QNbh/6q.xxxxxxxxxxxxxxxxcDcJ.'

2）其中配置中有个脚本： ./admin_script/hexo-generate.sh 需要自己创建：

➜ blemesh cat admin_script/hexo-generate.sh hexo g➜ blemesh chmod +x admin_script/hexo-generate.sh

这个脚本有什么用，啥时候触发？可以参考： https://www.jianshu.com/p/68e727dda16d step 5，admin后台管理博客有个deploy按钮，点击这个按钮就会执行这个脚本，该脚本会将md文件生成静态网页，如果用nginx配置去访问静态网页，速度会快很多。

四、nginx配置

配置nginx：编辑 /etc/nginx/nginx.conf 插入下面代码：

server {listen 3001;server_name www.beautifulzzzz.com;index index.html index.htm index;root /root/App/blemesh/public; }

之后重启nginx：nginx -s reload

注：
执行nginx后会报错误：nginx 403 Forbidden，原因是配置文件nginx.conf文件的执行用户和当前用户不一致导致的，把之前的nobody改成当前用户root。

五、增加tag

hexo主页下的tag标签、category标签无显示找不到：

解决办法：在主目录下执行 hexo new page "tags"或者hexo new page "category"
在/source/tags/index.md中设置修改

➜ blemesh cat ./source/tags/index.md ---type: "tags"comments: falsedate: 2019-02-24 02:53:03---

同理categories:

➜ blemesh cat ./source/category/index.md ---type: "category"comments: falsedate: 2019-02-24 02:53:34---

或者about me:

➜ blemesh cat ./source/about/index.md ---title: abouttype: "about-me"comments: falsedate: 2019-02-22 00:09:58---

六、后台启动

hexo server进程一直在后台运行的办法（执行hexo server -d &在一段时间后会停止hexo，此时无法打开后台），采用pm2接管hexo进程：

npm install -g pm2

在博客的根目录下创建一个hexo_run.js的文件，文件内容如下:

➜ blemesh cat hexo_run.js const { exec } = require('child_process')exec('hexo server -p 8001 -d',(error, stdout, stderr) => {if(error){console.log('exec error: ${error}')return}console.log('stdout: ${stdout}');console.log('stderr: ${stderr}');})

运行开启命令: pm2 start hexo_run.js

最后附上 zhouwaiqiang 写的一个hexo重启脚本restart_hexo.sh(需要先配置好nginx），需要重启刷新的时候执行source restart_hexo.sh即可：

➜ blemesh cat restart_hexo.sh #!/bin/bashPROCESS=`ps -ef|grep hexo|grep -v grep|grep -v PPID|awk '{ print $2 }'`PROC_NAME="pm2"for i in $PROCESSdoecho "Kill the $1 process [ $i ]"kill -9 $idonehexo clean #清除数据hexo generate #生成静态文件public文件夹ProcNumber=`ps -ef |grep -w $PROC_NAME|grep -v grep|wc -l`if [ $ProcNumber -le 0 ];thenpm2 start hexo_run.jselsepm2 restart hexo_run.jsfiservice nginx restart

七、体验