Halo博客迁移经验

本文使用人群：从 Halo1. x 迁移至 halo2 的创作者
迁移需要具备的基本条件：

• 1 台云服务器（轻量应用服务器）

• 1 个可以正常使用域名。

• 知道最基本的 Linux 系统概念

• 知道反向代理是什么

Halo 2 的官方文档更偏向于纯小白向，对于我这种半桶水反而不方便。本文基于使用 Docker Compose 部署 | Halo Documents 的官方教程，仅着重指出需要注意的地方，具体安装指导请以官方指南为准。

Step 1 准备工作

1. 建议直接重装系统，从一个纯净的 Linux 系统开始第一步。

2. 安装 docker，参考 Install Docker Engine | Docker Documentation ，一路复制即可
   如果成功安装，输入 docker version 和 docker compose version，2023 年 2 月后 docker 版本应当高于 23.0，docker compose 版本应当高于 2.16 。

Step 2 反向代理

1. 参考 Halo 官方指南 与 Nginx Proxy Manager 配合使用 | Halo Documents 。一切正常的话就可以进入 halo 的安装步骤。

2. 如果报错怎么办？
   报错的话建议删除 NPM 服务后重新来一次。

Step 3 安装 Halo2

终于来到了这一步。
我们首先创建容器组。使用官方镜像：（以 2.2.0 为例）

docker pull halohub/halo:2.2.0   

创建 docker-compose. yaml 文件时，特别注意一行代码的改动：

# 外部访问地址，请根据实际需要修改
      - --halo.external-url=http://localhost:8090/

其中的 http://localhost:8090 需要直接改为你的域名。比如我的域名是 weiblog. fun, 那么这行代码就应该是：

- --halo.external-url=weiblog.fun

这一点很重要！不然反向代理会出现各种莫名奇妙的错误!
不要使用服务器 ip: 8090!
不要使用服务器 ip: 8090!
不要使用服务器 ip: 8090!

然后我们直接使用 域名/console/ 即可进行设置

总结：

1. NPM 的安装设置要在 halo 之前；

2. 先自行拉取 halo 镜像更可靠；

3. compose. yaml 文件中直接使用域名即可，不要使用 ip：8090