Animeko 接入 Jellyfin / Emby - 自建媒体库联动
为什么要接入自建库
如果你自己搭了 Jellyfin 或 Emby，存了一堆下载好的番剧资源，Animeko 的接入能带来：
- 自建库的番剧直接在 Animeko 里播放——不用在两个应用间切换
- 和 Bangumi 追番收藏打通——你存在自建库里的番剧，在 Animeko 里标记追番后进度能同步
- 使用 Animeko 的播放器和弹幕功能——自建库的片也能叠加弹幕
Jellyfin 和 Emby 的区别
两者都是开源媒体服务器，主要区别在许可：
| 维度 | Jellyfin | Emby |
|---|---|---|
| 许可 | GPL（完全开源免费） | 闭源核心 + 开源客户端 |
| 插件 | 社区维护的免费插件 | 官方和社区插件 |
| 服务端 | 跨平台（Windows / macOS / Linux / Docker / 群晖等 NAS） | 同 Jellyfin |
| 对 Animeko 的接入 | 完全支持 | 完全支持 |
接入步骤在 Animeko 里基本一致，只有 API 端点格式略有差别。
接入步骤
- 确保自建库能正常访问——浏览器里打开你的 Jellyfin / Emby Web 界面确认
- 打开 Animeko → 设置 → 数据源管理 → 新增
- 选择 Jellyfin 或 Emby 类型（按你用的哪个选）
- 填入以下信息：
| 字段 | 填写内容 |
|---|---|
| 服务器地址 | 你的自建库地址（如 http://192.168.1.10:8096 或公网域名） |
| 用户名 / 密码 | 你在自建库上的账号（需要有权限访问「动漫」媒体库） |
| API Key（可选） | 如果不想存密码，可以用自建库生成的 API Key |
- 保存后 Animeko 会自动拉取你自建库的目录结构
接入后能做什么
| 功能 | 说明 |
|---|---|
| 浏览自建库内容 | Animeko 里能看到你自建库的番剧列表 |
| 播放自建库的片 | 用 Animeko 播放器播放你本地存的资源 |
| 叠加弹幕 | 自建库播放的番剧可以叠加弹弹play 弹幕 |
| 追番同步 | 标记自建库里的番为「在看」后，进度写入 Bangumi |
注意事项
- 自建库不在公网——如果只是内网访问，手机（移动网络）在外时播不了自建库的片。需要内网穿透或公网部署。
- API 访问权限——Jellyfin / Emby 账号要给足够的权限，至少能读媒体库。
- 资源命名——自建库的番剧目录结构和命名越规范，Animeko 匹配 Bangumi 条目越准确。
- 带宽——内网播放一般没问题，公网播放取决于你自建库服务器的上行带宽。
自建库 vs BT vs 在线
三种数据源各有所长，最终是互补关系：
| 场景 | 推荐源 |
|---|---|
| 当季新番、追更新 | BT + 在线 |
| 长期保存、随时回看 | 自建库 |
| 冷门老番、BT 无人做种 | 先试在线源，不行就等或找网盘 |
| 想要最高清 | BT 蓝光原盘 或 自己拷进自建库 |