RSS / Atom Feed 数据迁移指引

介绍

本指引提供了从 RSS 或 Atom Feed 文件迁移至 Halo 2.x 的方案。这两种导入方式的使用流程和限制基本一致，因此统一放在这一份文档中说明。

注意事项

1. RSS 文件需要符合 RSS 规范，并且 item 中最好包含 content:encoded 或完整正文的 description；否则迁移后可能只剩摘要内容。
2. Atom 文件需要符合 Atom Feed 规范，并尽量确保 entry 中包含完整正文内容。
3. RSS / Atom 迁移目前仅能导入文章，并且不支持分类、标签、评论、附件等结构化数据。
4. 通过 RSS / Atom 迁移的文章内图片及其他资源，会保留源站链接，迁移插件不会将其下载到 Halo。

准备工作

1. 准备符合规范的 RSS XML 文件、Atom XML 文件，或者确认可直接访问的 RSS / Atom Feed 链接。
2. 如源站内容依赖远程图片、音视频或附件，请确认这些链接在迁移后仍然可访问，因为插件不会下载这些资源。
3. 建议先抽样检查几个 RSS item 或 Atom entry 是否包含完整正文，避免迁移后只剩摘要内容。
4. 建议先在本地环境完成一轮完整导入测试，再考虑在生产环境执行。这样更方便快速重试和定位问题，也能避免线上因频繁请求后端、上传附件而出现导入变慢或部分失败；本地验证通过后，还可以结合 Halo 的备份恢复能力更快完成线上恢复或回滚。

执行迁移

1. 点击左侧菜单的迁移进入迁移页面。

2. 如果导入的是 RSS，选择 RSS；如果导入的是 Atom Feed，选择 Atom Feed，然后进入下一步。

3. 在上传数据步骤中，选择对应的 XML 文件，或者输入可直接访问的 RSS / Atom 地址并解析。

   

4. 确认数据概览无误后，进入下一步并开始迁移。