从其他应用迁移

把旧应用里的配置带进 HolyArrs，不用再手动填一遍。

HolyArrs 只读取旧应用。旧应用里什么都不会变，你的媒体文件也不会被移动。

开始之前

• 用所有者或管理员账户登录。
• 准备好每个旧应用的地址和 API 密钥。
• 确认 HolyArrs 能看到你的媒体文件夹。见文件夹和硬链接。

迁移你的配置

1. 打开 Settings > Move from other apps（设置 > 从其他应用迁移）。你应该会看到顶部排成一行的 5 个步骤。
2. Read（读取）：给每个旧应用点一次 Add an app（添加应用）。你应该会看到每个应用都列了出来，旁边带一个开关。
3. Choose（选择）：打开你想带过来的分组。
4. Try it（试运行）：看看会添加哪些内容。这一步什么都不会改。
5. Move（迁移）：点击 Move 并确认。迁移进行时可以离开这个页面。
6. Done（完成）：你应该会看到每个分组的结果和 Undo this move（撤销这次迁移）。

密钥和密码不会被带过来。见迁移之后。

迁移顺序

顺序	应用	为什么是这个顺序
1	Radarr、Sonarr	媒体库文件夹和条目要先到位。见 Sonarr 和 Radarr。
2	Lidarr、Prowlarr、Bazarr	音乐、来源和字幕语言。见 Lidarr、Bazarr 和 Prowlarr。
3	qBittorrent、SABnzbd	下载器。和上面的应用放在同一次迁移里读取。
4	Seerr、Overseerr	用户和请求，会和这里已有的条目对上。见请求类应用。

你可以把所有应用都读取完，一次全部迁移。只有分批迁移时，顺序才要紧。

迁移之后

下面每一项带过来时都是暂停或关闭的。填好它的密钥或密码，检查一遍，再打开。

项目	位置	要做什么
来源	Settings > Sources（设置 > 来源）	填入密钥，然后恢复使用。
下载器	Settings > Downloaders（设置 > 下载器）	填入密码或密钥，然后恢复使用。
通知	Settings > Alerts（设置 > 通知）	填入链接或邮件密码，然后打开。
外部列表	Settings > Outside lists（设置 > 外部列表）	检查文件夹和挑选规则，然后打开。Trakt 列表要先填你的 Trakt 密钥。
用户	Settings > Users and roles（设置 > 用户和角色）	发送邀请。

在旧应用里带标签的来源、下载器或通知，现在会对同类的所有条目生效。打开之前先检查一下。

来源和下载器带过来时，May reach the local network（可以访问局域网）是关闭的。只有它在你的家庭网络里时才打开。链路本地地址和云元数据地址不管开没开都会被拦截。

想一次填很多密钥，见从文件导入密钥。

哪些不会带过来

• 媒体文件。 迁移不会移动、重命名、复制或删除任何文件。
• 密钥、密码、令牌和 cookie。 Move 步骤和报告会把每一项列在 Keys to type again（需要重新填写的密钥）下面。
• 这里没有对应项的设置。 每一项都在 not moved（未迁移）列表里，并附有原因。
• 历史记录。 旧应用的历史记录不会被读取。但谁请求了某个条目，这一点会带过来。

如果不成功

现象	原因	解决办法
条目显示为找不到	它们的文件夹和这里的媒体库文件夹对不上。	在 Choose 的 Advanced（高级）里加一条路径规则，然后再迁移一次。
迁移时提示计划已变化	试运行之后有东西变了。	再运行一次 Try it，然后迁移。
迁移按钮是灰的	有一个用户需要你做选择，或者 HolyArrs 处于安全模式。	看按钮旁边的文字。
有些项目失败了	比如元数据服务器当时不可用。	等一会儿，再迁移一次。你的旧应用密钥还留着。

进阶

再次迁移、撤销、功能模块和安全模式

再次迁移。 每次迁移都记得自己添加了什么。再次迁移只会添加新的内容，其余的会标为 already here（已存在）。同一时间只能运行一次迁移或撤销。如果 HolyArrs 在迁移中途停了，下次启动时这次迁移会被标为失败；如果它的后台任务还在排队，就会接着运行。它不会挡住下一次迁移。

Earlier moves（之前的迁移）在读取列表下面，列出每一次迁移和它的状态。Open（打开）会显示这次迁移的第 5 步，如果它还在运行，则显示第 4 步。

撤销。 在第 5 步点击 Undo this move（更早的迁移要先点 Open 打开）。撤销在后台运行，只移除那次迁移添加的内容，从最新的开始：

• 条目从媒体库中移除，文件留在原处，
• 它添加的来源、下载器、通知、字幕站、用户、请求和永不添加列表里的记录会被移除，
• 它添加的外部列表，如果还处于暂停状态，会被移除，
• 命名、默认字幕语言和挑选规则上的等待期会变回原来的样子。

迁移之后你自己设置或改过的内容会保留，撤销报告会把它们列出来：你填的密钥或密码、你打开的用户或外部列表、你改过的命名、语言或等待期。放过条目的媒体库文件夹会保留，因为被移除的条目还留着历史记录。

功能模块。 关闭的功能模块会被跳过。电影关闭：不带电影文件夹、电影和外部列表。字幕关闭：不带字幕设置。请求关闭：不带请求。

安全模式。 可以读取、选择和试运行，但不能迁移或撤销。

API

API 密钥需要 admin（管理员）权限范围。

路由	作用
POST /api/v1/migrate/plan	所选读取的迁移计划，带数量和建议的路径规则。
POST /api/v1/migrate/dry-run	试运行报告和它的 plan_hash。什么都不会改。需要做选择的用户，其 choose 会被设为 same_name、numeric_id 或 merge_gone。
POST /api/v1/migrate/moves	开始一次迁移。需要试运行得到的 plan_hash。计划变了就返回 409。
GET /api/v1/migrate/moves	列出迁移，最新的在前。
GET /api/v1/migrate/moves/{id}	一次迁移，以及它的报告和进度。
GET /api/v1/migrate/moves/{id}/report	Markdown 文件格式的报告。
POST /api/v1/migrate/moves/{id}/undo	把撤销加入队列（202）。之后用 GET /api/v1/migrate/moves/{id} 跟进。

plan、dry-run 和 moves 的请求体（moves 还要带 "plan_hash"）：

{
  "snapshots": [1, 2],
  "path_rules": [{"from": "/data/media/movies", "to": "/movies"}],
  "skip": ["alerts"],
  "people": {"person:seerr:1": "owner", "person:seerr:3": "admin", "person:seerr:2": "merge"}
}

用户的选择可以是 owner（只能用于旧应用的所有者）、admin、merge 或 skip。可以跳过的分组：folders、pick_rules、titles、never_add、outside_lists、sources、downloaders、naming、subtitles、people、wishlist、alerts。

本节页面

页面	用来做什么
Sonarr 和 Radarr	把文件夹、剧集、电影和它们的规则带过来。先做这一步。
Lidarr、Bazarr 和 Prowlarr	把音乐、字幕语言和来源带过来。
Seerr 和 Overseerr	把用户和未完成的请求带过来。
读取旧应用	看 HolyArrs 到底读取什么、保留什么。
从文件导入密钥	一次填很多密钥。

相关页面

• 首次运行
• 术语表