Halo 1.x 数据迁移指引

介绍

本指引提供了从 Halo 1.5 / 1.6 迁移至 Halo 2.x 的方案。

在 Halo 后台的应用市场中搜索 站点迁移，安装并启用。

Halo 版本必须为 1.5.x 或 1.6.x。如果不满足，需要先升级到 1.5.x 或 1.6.x 版本。
Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 halo-sigs/awesome-halo 或应用市场查阅目前支持的主题。
Halo 2 默认没有内置 Markdown 编辑器。如果需要重新编辑迁移后的 Markdown 文章，需要额外安装 Markdown 编辑器插件。
Halo 2.0 不再内置友情链接、日志、图库等模块，需要安装额外的插件，目前官方已提供：
- 链接管理：https://www.halo.run/store/apps/app-hfbQg
- 图库：https://www.halo.run/store/apps/app-BmQJW
- 瞬间（原日志）：https://www.halo.run/store/apps/app-SnwWD
Halo 2.0 不再内置外部云存储的支持。需要安装额外的插件，目前官方已提供：
- S3（兼容国内主流的云存储）：https://www.halo.run/store/apps/app-Qxhpp
对于可识别且带有邮箱的来源用户，插件会在导入时优先匹配现有 Halo 用户；未匹配到时会自动创建 guest 用户，并尽量保留文章、页面、评论的归属关系。无法匹配的记录会回退为当前执行导入的用户。
为了防止直接升级 2.0 导致 1.x 的数据受到破坏，我们已经将工作目录由 ~/.halo 变更为 ~/.halo2。

在进行迁移操作之前，强烈建议先完整备份所有数据。
在 Halo 1.5.x / 1.6.x 后台导出最新的数据文件，后续插件会基于该 JSON 文件执行导入。
建议同时从旧站点服务器备份附件目录与相关云存储配置（可选）：
- 本地附件：备份 Halo 1.x 工作目录中的 upload 目录。
- 云存储附件：确认原存储桶、对象 Key 和访问配置仍可用。
提前安装迁移过程中可能需要的 Halo 插件：
- 链接管理：https://www.halo.run/store/apps/app-hfbQg
- 图库：https://www.halo.run/store/apps/app-BmQJW
- 瞬间（原日志）：https://www.halo.run/store/apps/app-SnwWD
- S3（如果需要迁移云存储附件）：https://www.halo.run/store/apps/app-Qxhpp
如果 Halo 1.x 中使用了云存储，建议先在 Halo 2.x 中创建对应的存储策略。
建议先在本地环境完成一轮完整导入测试，再考虑在生产环境执行。这样更方便快速重试和定位问题，也能避免线上因频繁请求后端、上传附件而出现导入变慢或部分失败；本地验证通过后，还可以结合 Halo 的备份恢复能力更快完成线上恢复或回滚。