Debrify连接Jellyfin与Emby:私人媒体服务器如何在应用内直点播

原创2026-11-09 20:26:181,761 阅读

Debrify连接Jellyfin与Emby:私人媒体服务器如何在应用内直点播

Debrify 是一款开源的跨平台个人媒体中心(Personal Media Hub),支持 Android、iOS、Windows、macOS、Linux 等多个平台。本文将教你如何把它与 Jellyfin 或 Emby 私人媒体服务器连接起来:无需离开应用,即可直接浏览并播放自己媒体库里的电影与剧集。

Debrify私人媒体服务器内建播放器直播电影界面

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。

步骤二:填写服务器地址并登录

  1. 选择服务器类型:Jellyfin 或 Emby
  2. 输入服务器 URL(如有反向代理,需带上 base path)
  3. 使用一个有权限播放目标媒体库的服务器账号登录

凭据会保存在加密的 Profile 资源注册表中:密码仅用于登录过程,令牌(token)则留在加密注册表内。对应数据模型可查看 media_server.dart。

步骤三:测试并管理连接

每个已连接服务器都提供三个操作按钮:

操作 用途
Test connection 快速验证服务器是否可达、凭据是否有效
Reconnect 令牌过期或权限变更时重新认证
Disconnect 移除连接;共享连接断开前会确认对其他 Profile 的影响

完整流程与测试说明见官方文档 docs/media-servers.md。

如何找到并播放服务器里的影片

方式一:在影片详情页直接选片源

打开一部电影或单集剧集的详情页,点击 Sources:服务器上的匹配版本会出现在该服务器的显示名称之下,并标注分辨率 / 容器 / 编码标签,点击即可播放。这些服务器片源在允许的情况下还会参与 Quick Play 快速播放。

方式二:在 Discover 中直接浏览服务器媒体库

不想依赖 ID 匹配?可以直接把整个服务器媒体库当目录来逛:

  1. 在 Discover 的 Source selector(来源选择器) 中选择 Jellyfin 或 Emby
  2. 选择已连接的服务器和目标视频媒体库
  3. 逐级浏览文件夹、剧集、季数和集数,或在当前媒体库/文件夹内搜索

「Recently Added(最近添加)」和「Continue Watching(继续观看)」列表使用服务器自身的媒体库数据与排序;点开任意影片都会在内建播放器中直接播放该服务器资源,无需 IMDb/TMDB 匹配,服务器内已索引的视频录像同样适用。你也可以将其设为默认的 Discover 来源,相关选项见 discover_settings_page.dart。

Debrify Discover搜索私人媒体服务器影片界面

Debrify剧集列表选择私人媒体服务器片源播放

观看进度与服务器同步

在 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。

登录后查看全文
debrify