Debrify连接Jellyfin与Emby:私人媒体服务器如何在应用内直点播
Debrify连接Jellyfin与Emby:私人媒体服务器如何在应用内直点播
Debrify 是一款开源的跨平台个人媒体中心(Personal Media Hub),支持 Android、iOS、Windows、macOS、Linux 等多个平台。本文将教你如何把它与 Jellyfin 或 Emby 私人媒体服务器连接起来:无需离开应用,即可直接浏览并播放自己媒体库里的电影与剧集。
Debrify 连接媒体服务器的原理
连接成功后,Debrify 会把服务器上的匹配片源直接注入应用的 Sources(资源来源) 列表:
- 精确 ID 匹配:仅通过完全一致的 IMDb、TMDB 或 TVDB 编号匹配,并校验返回的资源类型;剧集要求季数与集数完全一致(含第 0 季),不会仅凭片名猜测
- 原片直播:视频通过服务器流式传输到设备,始终使用内建播放器
- 多服务器支持:可同时连接多台服务器,并在来源优先级(source priority)中排序
⚠️ Debrify 不做转码(transcode)或重封装(remux)协商,设备需能解码原片的编码格式,并具备足够的网络带宽。
三步配置:连接Jellyfin与Emby服务器
步骤一:打开连接页面
进入 Settings → Jellyfin & Emby,点击 Connect server 即可开始连接。设置页入口源码见 settings_screen.dart,连接页面实现位于 media_server_settings_page.dart。
步骤二:填写服务器地址并登录
- 选择服务器类型:Jellyfin 或 Emby
- 输入服务器 URL(如有反向代理,需带上 base path)
- 使用一个有权限播放目标媒体库的服务器账号登录
凭据会保存在加密的 Profile 资源注册表中:密码仅用于登录过程,令牌(token)则留在加密注册表内。对应数据模型可查看 media_server.dart。
步骤三:测试并管理连接
每个已连接服务器都提供三个操作按钮:
| 操作 | 用途 |
|---|---|
| Test connection | 快速验证服务器是否可达、凭据是否有效 |
| Reconnect | 令牌过期或权限变更时重新认证 |
| Disconnect | 移除连接;共享连接断开前会确认对其他 Profile 的影响 |
完整流程与测试说明见官方文档 docs/media-servers.md。
如何找到并播放服务器里的影片
方式一:在影片详情页直接选片源
打开一部电影或单集剧集的详情页,点击 Sources:服务器上的匹配版本会出现在该服务器的显示名称之下,并标注分辨率 / 容器 / 编码标签,点击即可播放。这些服务器片源在允许的情况下还会参与 Quick Play 快速播放。
方式二:在 Discover 中直接浏览服务器媒体库
不想依赖 ID 匹配?可以直接把整个服务器媒体库当目录来逛:
- 在 Discover 的 Source selector(来源选择器) 中选择 Jellyfin 或 Emby
- 选择已连接的服务器和目标视频媒体库
- 逐级浏览文件夹、剧集、季数和集数,或在当前媒体库/文件夹内搜索
「Recently Added(最近添加)」和「Continue Watching(继续观看)」列表使用服务器自身的媒体库数据与排序;点开任意影片都会在内建播放器中直接播放该服务器资源,无需 IMDb/TMDB 匹配,服务器内已索引的视频录像同样适用。你也可以将其设为默认的 Discover 来源,相关选项见 discover_settings_page.dart。
观看进度与服务器同步
在 Settings → Jellyfin & Emby → Sync server watch progress 中,为当前 Profile 开启进度同步(默认关闭)。开启后:
- 打开影片前,Debrify 会先读取该用户在服务器上的续播点与已看状态;服务器时间戳更新时会替换本地书签
- 播放期间大约每 10 秒向服务器上报一次进度,暂停、拖动进度时也会同步
- 播放到结尾时立即上报「已观看」状态,即使播放器窗口还开着
这是播放驱动的同步而非后台媒体库镜像:其他应用产生的变化会在你下次打开服务器影片时读取;网络失败不会阻断播放,也不会有离线补传队列。同步实现见 media_server_watch_sync.dart,通信层见 media_server_client.dart 与 media_server_service.dart。
常见问题 FAQ
Q:可以把服务器里的影片下载到本地吗? 目前不可以。Jellyfin/Emby 片源的本地下载功能已禁用,因为后台下载器尚不支持其认证流的生命周期管理。
Q:能在 Discover 里看服务器的直播频道吗? 不包含。Discover 浏览面向视频媒体库(含已索引进库的录像),直播电视频道浏览不在支持范围内。
Q:动漫库集数编号不同能匹配吗? 匹配只认精确 ID 加精确季集号。采用不同编号或目录 ID 的动漫库,需要服务器端的元数据与之兼容后才能匹配成功。
Q:连接信息安全吗? 凭据走加密的 Profile 资源注册表并遵循其默认共享规则;Profile 切换、凭据变更或连接失效后,旧的搜索结果会立即作废。
总结
只需三步,Debrify 就能把 Jellyfin / Emby 服务器上的私人媒体库变成应用内可直点播的片源,并与详情页、Quick Play、来源优先级及进度同步无缝整合。完整的功能细节与真机验证记录(Jellyfin 12.1.0 与 Emby 4.9.3.0)可查阅 docs/media-servers.md。


