Jellyfin 与 Emby 资源库接入指南
为什么 Jellyfin 和 Emby 是首选
Jellyfin 和 Emby 是目前家庭影音领域最流行的两个媒体服务器软件——一个开源免费、一个商业闭源，功能几乎一模一样。Cinetry 对这两者的支持也是最完善的，包括播放进度同步、硬解开关、分类展示等全部功能。
连接参数
| 字段 | 说明 | 示例 |
|---|---|---|
| 资源库名称 | 自定义，用于区分多个服务器 | 家里的 Jellyfin |
| 连接地址 | 服务器 IP + 端口，带协议头 | http://192.168.1.100:8096 |
| 账号 | Jellyfin / Emby 登录账号 | admin |
| 密码 | 对应密码 | —— |
| UserAgent（可选） | 特殊网络环境下需要自定义，一般留空 | —— |
端口号说明
- Jellyfin 默认端口 8096（HTTP）或 8920（HTTPS）
- Emby 默认端口 8096（HTTP）或 8920（HTTPS）
- 如果在路由器上做了端口映射或使用了反向代理，填映射后的端口号
播放进度同步
连接成功后，Cinetry 会自动通过接口把你的播放进度回写到 Jellyfin / Emby 服务器。这意味着：
- 在手机上看到第 3 集第 15 分钟，换到电脑上打开同一集，会从第 16 分钟继续
- 在 Emby 官方客户端看过的进度，Cinetry 里也能接着放
- 反向也成立——Cinetry 里的进度会同步回官方客户端
这项功能默认开启，不需要额外设置。
硬解开关
Cinetry 连接 Jellyfin / Emby 时默认开启本地硬解。意思是视频解码工作由 Cinetry 播放器在你的设备本地完成，而不是让 Jellyfin / Emby 服务器转码再推流。
- 好处：零服务器压力、原画质输出、支持高规格格式（HDR / Dolby Vision / Dolby Atmos）
- 前提：你的设备能硬解对应的编码格式（H.264 / H.265 / AV1 等）
如果你发现某个视频硬解后有花屏或音画不同步，可以在播放器设置里关闭硬解，让 Jellyfin / Emby 服务器转码后推送。
常见连接问题
- 连接超时：检查 IP 地址是否正确、端口是否开放、手机和服务器是否在同一局域网。
- 账号密码错误：确认用的是 Jellyfin / Emby 的登录账号，不是 API Key。
- HTTPS 连接失败：旧版本服务器的自签名证书可能被拦截，试试切换到 HTTP 或者打开 HTTPS 证书验证开关（见后面常见问题排查）。
上一组：添加第一个资源库
下一篇：飞牛影视与苹果 CMS 接入