基于hexo + gitlab + nginx 搭建个人静态博客笔记
前言
最近刚买了一个服务器，打算搭建一个个人的博客小站。初步设想目标如下：
1. 搭建过程简单，技术通用，并且有很多个性的主题和插件
2. 基于markdown语法
3. 可以方便的发布与管理博客
4. 可以基于gitlab管理博客，方便迁移与版本管理
5.希望尽可能小消耗服务性能
实现效果如下：
日常维护说明：
实现步骤
环境说明：
centOS7.3 + nginx + jdk + git
根路径：/myblog/www
博客存储目录： /myblog/www/myblog 说明：这里myblog与gitlab仓库项目名一致
前提准备：
1. 有一定的linux基础，对node, npm有一定的了解，并会简单安装与配置
2. 熟悉git的常见命令与操作，并拥有一个gitlab仓库或者githup仓库，没有可以直接注册一个
3. 有一些编程基础
4. 如果中途有一些不知道的操作，可以参考文章末尾的连接
一、由于是静态网站，需要使用web服务器部署, 考虑到部署方便与性能问题，暂时选用nginx
1 安装nginx
#安装nginx
yum install -y nginx
2 修改工作目录为博客根目录/myblog/www/myblog，如果配置文件位置不一样的，可以用find命令查找 vi /etc/nginx/nginx.conf
3 在/myblog/www/myblog根目录下创建 index.html / 400.html / 500.html 文件， 可以直接用命令创建 ，这里无所谓，只是为了简单测试nginx服务器是否ok
echo '<body>测试</body>' > index.html
4 启动nginx，并在浏览器访问如下地址 http://你的ip:80/index.html 如果显示“测试”,则说明nginx配置成功, 如果使用的阿里云，需要开放对外访问端口80
5 nginx常见命令
# 启动 systemctl start nginx # 查看nginx是否运行 ps -ef|grep nginx # 重新加载 nginx -s reload
二、 git安装，用于动态更新与发布我们的博客
1 安装git
#安装git
yum install -y git
2 进入我们的博客根路径 /myblog/www， 并克隆gitlab仓库到当前目录, 这里需要提前配置好 ssh key,让服务器可以直接拉取gitlab仓库的内容
#拉取仓库到服务器本地 git clong -b master git git@gitee.com:xxxx/myblog.git
3 在我们的根目录下创建脚本 update.sh, 这里我们先创建，后面我们使用gitee的webhook钩子直接触发更新,内容如下
#!/bin/bash cd /myblog/www/myblog && /usr/bin/git pull
说明：这里注意当前目录与 git命令在脚本里写法
4 对刚刚创建的脚本授权，赋予执行权限，这里可以直接测试刚刚的脚本是否能正常更新我们的博客
chmod -R u+x update.sh
如果显示上图，则说明脚本正常
三、 hexo博客框架获取与初始化， 这里假设已经安装和配置好node.js，npm
1. 在自己的电脑本地，新建个人博客目录，用于日常编写博客 E:\newwork\myblog\hexo
1. 安装 hexo命令 npm install -g hexo 2. 初始化 hexo项目框架, 这里注意hexo (hexo: 5.4.0) ,node.js(7.17.0)， npm(v12.22.1) 的版本 hexo init 3. 生成博客 hexo g 4. 启动测试, 默认端口是 4100 hexo s 5. 上传博客到gitlab, 这里需要配置_config.yml，同时需要配置ssh key hexo d
2. 在步骤2，生成博客基础代码后，修改当前目录下配置文件 _config.yml, 按如下配置gitlib仓库信息
4. 上传博客到gitlab,并自动发布到服务器
1. 比如你新写了一篇博客，需要发布到服务器
# 1.重新生成 hexo g # 2. 更新到gitee仓库 hexo d
2. 这时你新发布的文章已经自动提交到了gitee仓库
3. 将提交到gitee仓库的代码自动发布到服务器，这里我们使用 webhook，调用一个http的接口，自动触发我们刚刚在博客根目录下的update.sh脚本，这里使用的java 的web服务，（熟悉其他技术的可以自由替换）
@PostMapping("/update")
public String update() {
try {
# 这里是我们刚刚配置 update脚本的位置，直接替换掉就可以
String shell = "sh /myblog/www/update.sh";
log.info("执行命令：{}", shell );
Process process = null;
List<String> processResult = new ArrayList<String>();
process = Runtime.getRuntime().exec(shell , null, null);
BufferedReader input = new BufferedReader(new InputStreamReader(process.getInputStream()));
String line = "";
while ((line = input.readLine()) != null) {
processResult.add(line);
}
log.info("执行结果：{}", processResult );
} catch (Exception e) {
e.printStackTrace();
}
return "请求陈功";
}
对应shell脚本为，注意脚本的路径与写法：
#!/bin/bash echo "开始执行" >> a.txt cd /myblog/www/myblog && /usr/bin/git pull echo "执行结束" >> a.txt
4. 在gitee仓库页面 【管理】-> 【Web Hook管理】新增一个post请求地址，保存就可，比如：http://你的ip:8081/api/update ,根据具体接口替换即可
5. 这里可以修改一下自己的博客，然后按步骤1重新跑一下，然后重新访问一下自己的博客，http://你的ip/index.html，就会看到效果，以后发布，只需要用下面的命令即可
#发布博客 hexo d
备注参考地址：
配置sskey: https://gitee.com/help/categories/38
配置web hook:https://gitee.com/help/articles/4184
git常见命令：https://www.cnblogs.com/mengdd/p/4153773.html
阿里云端口开放：https://jingyan.baidu.com/article/03b2f78c31bdea5ea237ae88.html
hexo常用操作：https://hexo.io/zh-cn/docs/index.html
node,npm的安装：https://jingyan.baidu.com/article/e4511cf38c05092b845eaf9b.html
