AfuseKt 直连 Emby、Jellyfin、Plex 媒体服务器
三个媒体服务器的区别
Emby、Jellyfin、Plex 都是流行的家庭媒体服务器软件，能扫描本地文件、抓取元数据、生成精美海报墙，然后通过客户端 App 在各种设备上播放。AfuseKt 对这三个都做了直连支持。
| 服务器 | 来源 | 许可 | 客户端体验 | AfuseKt 接入方式 |
|---|---|---|---|---|
| Emby | Emby LLC | 商业（免费版有功能限制） | 客户端 App 体验好 | 直连（API 接入） |
| Jellyfin | Emby 社区分叉 | 100% 开源 | 界面简约 | 直连（API 接入） |
| Plex | Plex Inc. | 商业 | 订阅制，生态最大 | 直连（API 接入） |
为什么用直连而不是 SMB / WebDAV
Emby/Jellyfin/Plex 直连的好处：
- 直接使用服务器元数据：不用在 AfuseKt 里重新刮削，服务器已经替你刮好了
- 服务器提供的排序和分类：AfuseKt 能展示 Emby/Jellyfin Server 上创建的媒体库分组
- 观看记录同步：播放进度自动同步回服务器，换设备继续看
- 片头片尾信息：Emby 4.8+ 可返回片头片尾时长，AfuseKt 自动跳过
- 多用户支持：每个用户有各自的观看历史和收藏
前提：你已经在 NAS 或服务器上部署了 Emby / Jellyfin / Plex Server，并通过浏览器完成了初始设置。
添加步骤（以 Emby 为例）
- 侧栏 → 资源库 → 添加资源库 → Emby（或 Jellyfin / Plex）
- 填写连接信息：
- 服务器地址：
http://NAS-IP:8096（Emby 默认 8096）或https://你的域名 - 用户名 / 密码：Emby Server 上的用户账号（不是管理员）
- 可选：勾选"使用 HTTPS"、设置端口、添加 Token
- 连接成功后，AfuseKt 会列出服务器上的所有媒体库，选择要同步的
- 直接进入服务器提供的海报墙视图——不需要再走刮削流程
Jellyfin 和 Plex 同理
三个服务器的连接步骤几乎一致，只是端口默认值不同：
| 服务器 | 默认 HTTP 端口 | 默认 HTTPS 端口 |
|---|---|---|
| Emby | 8096 | 8920 |
| Jellyfin | 8096 | 8920 |
| Plex | 32400 | 32400（同端口） |
进阶配置
片头片尾自动跳过：Emby Server 4.8+ 会在 API 中返回片头片尾时间戳，AfuseKt 读取后自动跳过，无需手动设置。Jellyfin 和 Plex 目前也在加入类似支持。
媒体库排序和隐藏：Emby/Jellyfin Server 上创建的筛选视图（按类型、评分、年份排序）会同步到 AfuseKt 资源库中。需要 Emby 4.8+ 版本支持。
公网访问：如果要在外出时访问家里的 Emby/Jellyfin，需要做内网穿透（端口映射 + DDNS），或使用 Tailscale / ZeroTier 组网。Plex 自带 Plex Relay 公网穿透能力（免费版也可用）。
和其他协议的搭配
- Emby + SMB：Emby 负责元数据管理，SMB 负责直接读文件。如果 Emby 某个剧没配好元数据，AfuseKt 可以用 SMB 接入同一目录后重新刮削
- Emby + 阿里云盘：把 Emby Server 的媒体库指向挂载了阿里云盘的目录（通过 rclone 等工具本地挂载），一次刮削到处用
- 多服务器：AfuseKt 可以同时接入 Emby + Jellyfin + Plex，在首页分别展示各服务器的海报墙
常见问题
| 问题 | 解决 |
|---|---|
| 连接提示 401 Unauthorized | 用户名密码错误；或 Emby/Jellyfin Server 需开启 API 访问权限 |
| 连接成功但看不到媒体库 | 服务器上该用户未授权媒体库访问；或服务器版本过低 |
| 播放需要缓冲但 SMB 直接播放很顺 | Emby 可能在做实时转码，禁用转码直接原始流播放；或在服务器端开启 DirectPlay |
| Jellyfin 不显示头像 | 清缓存后重新登录；Jellyfin 10.8+ 已修复部分头像显示问题 |
| 公网访问慢 | 换 Tailscale 组网或升级服务器带宽；Plex 用户开启 Relay |