hexo 迁移云服务【我的个人天地】

hexo 迁移云服务

创建于 2020-10-12

更新于 2024-12-26

科技

hexo

云服务

前言

之前个人主页一直挂在 coding 上，好久没有看过了，结果发现必须要自有域名才能继续访问。趁着还云服务的学生服务器，和以前买来蹭免费邮件服务器的域名，准备迁移到云服务上。

一、域名及服务器

现在云服务的生态已经非常丰富了，所有工作可以在主流的云服务厂商一站式搞定，我目前部署在 阿里云 中，下文介绍也以 阿里云 为主。

1.1 域名

买域名没什么说的（点击购买），唯一要提的一点是国内域名需要备案，不过很简单，各大厂商都提供一站式服务（点击备案）。之后可以顺便使用证书服务给自己的网站注册一个免费的 SSL 证书（点击注册），方便后续对个人主页进行 HTTPS 方面的设置。

1.2 服务器购买

开发者成长计划对用户还是很友好的，性能上 一核 2G 1M带宽 也够普通用户折腾了。自带公网 IPv4 地址，~~要是还配 IPv6 地址就再好不过了~~。（貌似新版服务器已经支持 IPv6）我这里买的是 Ubuntu 的操作系统，因为这个用的多，具体用什么操作系统，看自己习惯就好。Windows 就算了，这个配置也够呛能跑动，另外记得开启安全组端口和密钥对。

云服务器管理 - 网络与安全 - 安全组 - 手动添加 80 端口和 443 端口
云服务器管理 - 网络与安全 - 密钥对 - 创建密钥对&绑定密钥对

1.3 服务器配置

服务器购买完成当然是要先配置一番，基础的操作命令就不再说了，由于是 root 权限 进入系统，所有的命令就不在带上 sudo 了。如果之前已经绑定了密钥对，这里可以直接使用密钥登录服务器。

1.3.1 开放端口

服务器默认是打开防火墙并屏蔽除 SSH 外的各种端口的，这里需要用 Ubuntu 自己的 UFW 命令放行网页服务所需端口。

bash
1
2
ufw allow 80/tcp
ufw allow 433/tcp

1.3.2 安装 `nginx`

端口开放以后需要配置 nginx 来作为 hexo 运行的服务器，安装并启动的命令如下，nginx 配置的默认路径为 /etc/nginx。

bash
1
2
3
apt install nginx -y
systemctl start nginx
systemctl enable nginx

1.3.3 配置 `nginx` 网页服务

启动服务后直接访问服务器 公网 IP 即可打开 nginx 的默认页面，如果无法打开，请确认安全组和防火墙的设置问题。
打开后第一步可以先在域名解析服务中将刚才已经购买并注册 SSL 证书 的域名指向该 IP，然后进入目录 /etc/nginx/conf.d 对个人主页的相关服务信息进行配置，首先创建个人主页的配置文件 vi hexo.conf，然后对内容进行修改。

conf
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
server {
  listen 443;
  server_name youdomain;
  ssl on;
  ssl_certificate /etc/ssl/youdomain.pem;
  ssl_certificate_key /etc/ssl/youdomain.key;
  ssl_session_timeout 5m;
  ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4; #使用此加密套件。
  ssl_protocols TLSv1 TLSv1.1 TLSv1.2; #使用该协议进行配置。
  ssl_prefer_server_ciphers on;
  location / {
    root /home/git/www/hexo;
    index index.html;
  }
}
server {
  listen 80;
  server_name youdomain;
  rewrite ^/(.*)$ https://youdomain:443/$1 permanent;
}

第一个 server 是用来配置 HTTPS 访问，SSL 证书的 pem 文件 和 key 文件 可以在阿里云的证书控制台中下载，然后上传到服务器的 /etc/ssl 目录即可。location 中的 root 路径是个人主页的根地址，之所以是 /home/git 是因为之后要对 git 进行操作，完成个人主页的自动部署。
第二个 server 是用来配置 HTTP 访问，将所有的 HTTP 请求 转换为 HTTPS 请求。如果不需要设置 HTTPS 访问，可以按照如下进行设置。

conf
1
2
3
4
5
6
7
8
server {
  listen  80;
  server_name     youdomain;
  location / {
    root    /home/git/www/hexo;
    index   index.html;
  }
}

1.3.4 配置 git

这一步就是为了让我们可以本地编辑完成后直接通过 hexo d 命令一键将博文部署到服务器。

通过 adduser git 创建 git 用户，并配置密码。
通过 adduser git sudo 授予 git 用户 管理员权限。或通过以下代码手动添加权限。

bash
1
2
3
4
5
6
7
8
9
chmod 740 /etc/sudoers
vi /etc/sudoers

# User privilege specification
root ALL=(ALL:ALL) ALL
git  ALL=(ALL:ALL) ALL  #添加这一行
# Members of the admin group may gain root privileges

chmod 400 /etc/sudoers

对 git 用户 进行配置。

bash
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 切换到 git 用户
su git
cd ~

# 创建个人主页根目录
mkdir www
cd www
mkdir hexo

# 添加 ssl 密钥 (authorized_keys 文件来自默认登录用户的对应目录)
cd ~
mkdir .ssh
sudo cp /root/.ssh/authorized_keys /home/git/.ssh/
sudo chown git:git /home/git/.ssh/authorized_keys

# 创建 git 仓库
git init --bare hexo.git

# 添加并赋予 hooks 执行权限
vi ~/hexo.git/hooks/post-receive

git --work-tree=/home/git/www/hexo --git-dir=/home/git/hexo.git checkout -f

chmod +x ~/hexo.git/hooks/post-receive

至此对服务器的配置已经完成，之后是对本机的 hexo 进行安装和配置。

二、`hexo` 版本升级

由于好久没有更新过个人主页，电脑在此期间也经历过重装系统，所以一切配置都要从头再来。电脑环境为 Windows，后续安装都是基于 Windows 10。

2.1 配置 `NodeJS`

2.1.1 下载

下载安装包，我这里通过清华大学的镜像站进行下载。这里选择的是绿色免安装版，后续需要对环境变量进行设置。

2.1.2 配置环境变量

首先将文件解压缩到自己指定的目录，然后再用户环境变量中添加 NODE_HOME，变量指向 NodeJS 解压目录。然后在用户的 path 中添加 %NODE_HOME 和 %NODE_PATH%\node_global。

2.1.3 修改 `npm` 包安装位置

在 NodeJS 解压目录中建立 node_global 及 node_cache 两个文件夹。然后执行命令：

bash
1
2
3
# 将'NodeJS解压目录'替换为自己的实际目录
npm config set cache "NodeJS解压目录\node_cache"
npm config set prefix "NodeJS解压目录\node_global"

2.1.4 修改 `npm 源`

默认的安装源在国外，下载不稳定，可以调整到淘宝源。

bash
1
2
3
4
# 配置
npm config set registry https://registry.npmmirror.com
# 验证
npm config get registry

2.2 更新 `hexo` 相关包

首先通过 npm install -g hexo-cli 安装 hexo-cli。

然后由于个人主页的许多配置都是两年前的，已经非常落后了，为此，对 npm 包 进行升级。

全局升级 hexo-cli，首先通过 hexo version 查看当前版本，然后执行 npm i hexo-cli -g，再次使用 hexo version 查看是否升级成功。截至 2020/10/12，hexo 最新版本为 5.2.0。
使用 npm install -g npm-check 和 npm-check，检查系统中的插件是否有升级的，可以看到自己前面都安装了那些插件。
使用 npm-check -u，升级系统中的插件。

2.3 `hexo-asset-image` 插件 bug 修改

hexo-asset-image插件的作用是将 md 文件中的图片路径在生成个人主页是动态转换为对应网址路径，然而对应的 npm 包存在 bug，会导致路径生成出现错误。该 bug 作者在 github 中已经修改，但是没有发布新的 npm 包，所以需要手动修复文件。对应的修改操作为该commit。文件位置在./node_modules/hexo-asset-image/index.js。

目前 bug 已经被修复，新版插件已经不需要在修改对应源码。

git
1
2
24  -   var endPos = link.lastIndexOf('.');
24  +   var endPos = link.length-1;

2.4 `hexo-browsersync` 问题小记

在某次重启电脑后执行 hexo s 命令时发现 hexo-browsersync 所需要的 3000 端口被占用，提示 listen EACCES。通过 netstat 指令却找不到相关进程信息。在一顿搜索后发现是 hyper-V 对端口进行了保留，当要修改保留端口时提示进程被占用，重启电脑后发现保留端口自己修改了，不再冲突。查看和修改预保留端口命令如下，我差点就想重置 winsock 了。

bash
1
2
3
netsh interface ipv4 show excludedportrange protocol=tcp
netsh int ipv4 set dynamicport tcp start=49152 num=16383
netsh int ipv4 add excludedportrange protocol=tcp startport=3000 numberofports=1

三、`hexo` 主题修改

3.1 选择主题

在升级完 hexo 以后，无奈的发现主题适配存在问题，于是重新搜索主题（前端实属不精，就不自己献丑搞了），最后敲定了主题：Fan。

首先将主题 fork 到自己的仓库中，然后按照主题的 GitHub 页面进行相关配置。
该主题在 Hexo 5.0.0+ 版本中存在侧边栏 toc 无法正确响应的 bug，经排查后发现是 hexo 本身的 toc 生成机制对跳转路径进行了转码，但文章生成时没有转码，导致函数无法正确识别 toc-link。在主题的 sidebar.js 文件结尾添加如下代码将侧边栏的 toc-link 重新解码即可。修改已经贡献到主题。

js
1
2
3
4
5
6
7
8
/**
 * @description 为 toc-link 重新解码
 */
var list = document.getElementsByClassName("toc-link");
for (var i in list) {
  var tochref = decodeURI(list[i].getAttribute("href"));
  list[i].href = tochref;
}

3.2 修改目录结构

默认的 hexo 新文章都生成在 \source\_post 目录下，当文章数目变多时无法快速查找，为此将文章以年为单位进行归类。修改根目录下的 _config.yml 文件。然后将现有文章进行分类归纳，命令行一键操作可参考博文——如何在 Hexo 中对文章 md 文件分类。

yml
1
2
new_post_name: :year/:title
permalink: :year/:month/:day/:name/

四、网站推送

在一切配置完成以后，需要通过 hexo-deployer-git 插件设置推送服务，从而做到自动推送更新个人主页。

安装插件。

bash
1
2
npm install hexo-cli -g
npm install hexo-deployer-git --save

配置推送地址。其中 repo 栏的设置参数与第二章配置一致。

yml
1
2
3
4
5
6
7
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  message:
  repo: git@youdomain:/home/git/hexo.git
  branch: master

新版 git 更新了可信域机制，需要将 .deploy_git 对应目录添加到安全目录里面才可以完成部署。

bash
1
git config --global --add safe.directory 'your-projrct-dir/.deploy_git'

执行 hexo clean && hexo g && hexo d 推送个人主页。此处需要将云服务器生成的密钥，导入到本地计算机中。

参考

本文作者: 有次元袋的 tiger

本文链接: https://www.superheaoz.top/2020/10/8357/

前言

一、域名及服务器

1.1 域名

1.2 服务器购买

1.3 服务器配置

1.3.1 开放端口

1.3.2 安装 nginx

1.3.3 配置 nginx 网页服务

1.3.4 配置 git

二、hexo 版本升级

2.1 配置 NodeJS