一个App连接多套媒体服务器:JellyBox Player 无缝切换 Jellyfin、Emby 与 Navidrome 指南

原创2026-10-28 22:44:461,674 阅读

一个App连接多套媒体服务器:JellyBox Player 无缝切换 Jellyfin、Emby 与 Navidrome 指南

JellyBox Player 是一款原生桌面与移动端音乐播放器,支持一个 App 同时连接多套 Jellyfin、Emby 与 Navidrome 媒体服务器,并可一键免登出切换。它自带 Spotify 风格播放列表、歌词、离线下载、CarPlay 与 Android Auto,让自托管音乐库拥有媲美商业流媒体的体验。

JellyBox Player 多服务器音乐播放器主界面

为什么需要"一个 App 连多台服务器"

如果你同时维护着 Jellyfin、Emby 或 Navidrome 这类自托管媒体服务器,传统做法是每个服务器配一个专属客户端。而 JellyBox Player 的设计思路是:一个 App 装下所有服务器,账号可共存,切换不打断播放体验。

核心优势一览:

  • 🎯 三种协议原生支持:Jellyfin、Emby、Navidrome(兼容 OpenSubsonic API)
  • 🔍 自动探测服务器类型:输入地址即可识别,无需手动选择
  • 🔁 多账号一键切换:在已保存的服务器之间来回切换,无需退出重新登录
  • 💾 播放队列记忆:切换服务器后恢复各自的播放队列与进度

⚠️ 提示:JellyBox 是客户端,不是服务器。你需要先拥有一台运行中的 Jellyfin、Emby 或 Navidrome 服务器,并且其中已导入音乐库。

支持哪些服务器?三套 API 引擎自动就位

JellyBox 内置三套独立的认证与客户端引擎,分别对接三种协议:

服务器类型 协议 说明
Jellyfin MediaBrowser API 官方认证支持,额外提供 Quick Connect 快速登录
Emby MediaBrowser API 与 Jellyfin 共用探测通道,自动区分
Navidrome Subsonic API 任何 OpenSubsonic 兼容服务器也可尝试连接

这三套引擎的分发逻辑集中在 media_server_backends.dart 中,按服务器类型自动选择对应的认证器与客户端。你不需要关心背后用的是哪套 API——JellyBox 会自动处理。

服务器类型自动探测,输入地址即可识别

登录页在输入服务器地址时会实时发起探测(probe),从服务器返回的 ProductName 等字段判断它是 Jellyfin 还是 Emby,对 Subsonic 系服务器则走 /rest 接口探测版本信息。探测逻辑可参考:

也就是说,即使是 Jellyfin 和 Emby 共用同一个 MediaBrowser 协议栈,JellyBox 也能自动分辨出该用哪套认证流程。

多账号管理:一次登录,永久保存

添加第一台服务器后,你随时可以再添加第二台、第三台。所有账号保存在本地列表中(见 account_store.dart),当前激活的服务器由 currentServerId 标识。

切换逻辑在 auth_provider.dart 的 switchTo 方法中实现:切换到另一台已保存的服务器时,它会先释放当前连接,再从本地凭据直接恢复目标会话(_restoreSession),不会要求你重新输入密码。

JellyBox Player 桌面端与移动端跨平台界面

一键切换步骤

  1. 打开 App,点击顶部的服务器/账号区域,弹出已保存的服务器列表(组件见 server_accounts.dart)
  2. 点击目标服务器,JellyBox 自动完成会话恢复
  3. 该服务器自己的播放队列、最近播放也会随之还原

在多音乐库的服务器上,还可以继续通过库选择器(library_selector_button.dart)在同一个服务器内的不同音乐库之间切换。

切换时播放体验不断层

很多客户端"换服务器"意味着播放全丢,JellyBox 在这方面做了专门处理:

  • 队列记忆:App 重启后仍会恢复上次的队列和播放位置(_restoreQueue 会在切换完成后自动触发)
  • 独立流媒体配置文件:每台服务器连接都有自己的 streaming profile,如果服务器不支持原生解码,会自动转码
  • 音质徽章:界面上始终显示当前是否播放的是原始文件,多服务器场景下不会混淆
  • 播放记忆跨服务器:换到第二台服务器时,第一台的进度不丢失,切回来继续

多服务器之外,这些能力同样通用

无论你连接的是 Jellyfin、Emby 还是 Navidrome,以下功能开箱即用:

  • 🔎 全局搜索专辑、歌手、歌曲、歌单,也可按类型过滤
  • 📜 时间轴同步歌词
  • ⬇️ 专辑/单曲离线下载,支持飞行模式离线模式
  • 🚗 Apple CarPlay 与 Android Auto(Beta)
  • 📺 投屏到 DLNA / UPnP 设备(智能电视、网络音箱)
  • 🎨 主题色跟随专辑封面自动提取,附带全屏 Studio Mode

JellyBox Player 移动端横屏播放器界面

常见问题

Q:支持哪几种服务器? Jellyfin、Emby 和 Navidrome。其他 OpenSubsonic 兼容服务器可以试一试,但官方仅保证 Navidrome 的兼容性。

Q:切换服务器需要重新登录吗? 不需要。已保存的账号凭据保存在本地,切换时直接恢复会话(源码:auth_provider.dart)。

Q:删除某台服务器会影响其他服务器吗? 不会。各账号独立保存;移除某台服务器时,只会清理属于它的本地下载数据。

Q:如何贡献代码? JellyBox 基于 Flutter + Dart 3.8 开发,欢迎提交 Issue 与 Pull Request,流程详见 CONTRIBUTING.md。

小结

一个 App 连接多套媒体服务器,JellyBox Player 把"多服务器音乐库"的体验做到了免登出切换、队列各自记忆、协议自动识别的程度。如果你正在运行 Jellyfin、Emby 或 Navidrome,它就是那个把自托管音乐库"流媒体化"的播放器。

登录后查看全文
JellyBoxPlayer