从 Emby 迁移

你可以把现有 Emby 服务器上的媒体库、成员、元数据、图片和观看记录导入 Kryspal Media。导入只会从 Emby 读取数据，所以导入期间 Emby 可以照常使用。

开始之前#

导入是只读的：不会改动 Emby 的设置、媒体库和文件，也不会让 Emby 扫描或播放。不需要先停掉 Emby。两者可以同时在同一台机器上运行：Kryspal Media 默认使用 5797 端口，不会和 Emby 抢端口。

准备三件事：

1. Emby 的 API 密钥。 在 Emby 控制台创建一个管理员 API 密钥，导入时粘贴。密钥只用来连接，不会被保存，导入后可以在 Emby 里删除。
2. 能读到视频文件。 两台服务器通常在同一台 NAS 上，视频在同一个文件夹。如果 Kryspal Media 运行在 Docker 里，需要把媒体库文件夹挂载进容器。
3. 已完成首次设置， 并选好第三方播放器兼容。多数人选“兼容 Emby 的第三方播放器”，原来的第三方播放器只要换成新的服务器地址即可。

会带过来的内容#

Emby 的「混合内容」媒体库，导入后保留为混合库，服务器依文件夹与文件名判断哪些是剧集；建议之后拆成电影库和剧集库。

不会带过来的内容#

选择导入方式#

每个媒体库可以各选一种。

完整导入（默认）。 一部一部从 Emby 读取元数据、演职员和图片。每部完成后立刻就是完整的样子，不需要再刮削。适合 Emby 没有把元数据存成文件，或你想“以 Emby 现在的样子为准”的情况。

依本地 NFO 重建。 Kryspal Media 自己扫描视频旁边的 NFO 和图片文件来重建元数据，不向 Emby 拉取元数据、演员和图片。Emby 只提供媒体库设置、成员、观看记录、喜爱，以及你手动锁定的字段。对 Emby 的请求最少，速度更快。适合 Emby 已把元数据存进媒体文件夹（Emby 媒体库里“把元数据保存到媒体文件夹”选项，格式选 Nfo）的情况，Emby 背后是网盘时尤其合适。

使用 NFO 重建时，如果你在 Emby 里改过的内容没有写回 NFO（或 NFO 比 Emby 旧），两边不同的地方会采用 Emby 的值。

操作步骤#

1. 打开管理后台，进入 系统 → 迁移导入。来源服务器的类型选 Emby，填入 Emby 的网址（例如 http://192.168.1.10:8096，不要加 /emby）和 API 密钥。
2. 点 预览。页面会列出 Emby 的媒体库、影片数量、成员，以及每个媒体库的文件夹在本服务器上是否存在。
3. 需要时设置 路径对照。Emby 记录的是它自己看到的路径（例如 /mnt/movies/...），本服务器要换成自己看到的路径。写法是“来源路径 → 本机路径”，例如 /mnt/movies → /media/movies。两边路径完全相同就不用设置。预览里每个文件夹都显示“本机存在”后再开始。 显示“本机不存在”，表示对照写错了，或本服务器没有挂载那个文件夹。如果预览提示某个文件夹不在允许的媒体根目录内，请设置路径对照，或把该路径加入服务器的环境变量 MEDIA_ROOT。
4. 选择要导入的媒体库和成员，并为每个媒体库选一种 导入方式，并设好它的 存储位置（本机；Emby 的文件在网盘上就选云端硬盘；已有的媒体库沿用自己的设置）。建议保持勾选 观看记录与喜爱。
5. 开始导入。导入在后台进行，可以关掉页面。进度、速度、剩余时间和正在处理的片名，会显示在导入页面和 任务 里。

导入期间与之后#

• 每完成一部就能观看。 导入过程中可以照常浏览媒体库。默认从影片数最少的媒体库开始，最快有东西可看；每个媒体库由最近添加的往前处理。
• 可以 暂停 再 继续。中断（重启、断网或取消）后，到 最近的导入 点 续传。已完成的不会重做，失败的会重试。续传时需要重新输入 Emby 的密钥，因为密钥从不保存。
• 全部完成后，服务器会再扫描一次，补上 Emby 不知道的新文件，这些新文件按一般流程刮削。
• 资料完整的影片视为已识别，不再刮削；没有元数据的（没有海报，或简介、类型、演职员全空）会排入刮削。

完成后：

1. 查看报告。 报告列出各项数量，以及略过、失败、对应不到的项目和原因。“已合并版本”不是失败，只是 Emby 里同一部片的不同版本被合并成了一部。“对应不到”最常见的原因是路径对照写错，或本服务器看不到那些文件。
2. 到 成员 为导入的成员设置密码，然后启用。
3. 对照几部片。 挑几部手动编辑过、有观看记录的，和 Emby 核对。
4. 检查成员数量。 所有成员都会导入，不会丢数据。如果成员数超过方案上限，超出的成员要等你升级或调整保留名单后才能使用。PRO 和 MAX 的上限更高。
5. 把播放器指向新服务器。 在“兼容 Emby 的第三方播放器”模式下，原来的第三方播放器输入新的地址、用户名和密码即可使用。Emby 也可以继续用。之后两边的观看记录各自独立；重新运行导入时，只有 Emby 的最后播放时间比本机新，才会覆盖本机。

需要多久#

取决于媒体库大小、Emby 的响应速度和网络。

• 大型媒体库的完整导入可能需要数小时，请预留比预期更长的时间。
• 已导入过再重跑会快得多。
• 依本地 NFO 重建对 Emby 的请求少得多，通常明显更快。
• 进度页面显示的剩余时间会根据实测速度自动修正。

想尽量少打扰 Emby：

• 优先使用 依本地 NFO 重建。
• Emby 背后是网盘的媒体库，导入时把 存储位置 选成云端硬盘，会自动放慢；先挑一个小的媒体库试跑。网盘额度很紧时，可以按媒体库分天执行。先挑一个小的媒体库试跑。
• 默认值适合 Emby 在同一个局域网的情况，一般不用修改。

常见问题#