一个App连接多套媒体服务器:JellyBox Player 无缝切换 Jellyfin、Emby 与 Navidrome 指南
一个App连接多套媒体服务器:JellyBox Player 无缝切换 Jellyfin、Emby 与 Navidrome 指南
JellyBox Player 是一款原生桌面与移动端音乐播放器,支持一个 App 同时连接多套 Jellyfin、Emby 与 Navidrome 媒体服务器,并可一键免登出切换。它自带 Spotify 风格播放列表、歌词、离线下载、CarPlay 与 Android Auto,让自托管音乐库拥有媲美商业流媒体的体验。
为什么需要"一个 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 接口探测版本信息。探测逻辑可参考:
- mediabrowser_probe.dart:识别 Jellyfin / Emby
- subsonic_probe.dart:识别 Navidrome 等 Subsonic 服务器
- login_page.dart:登录页的地址探测与 Quick Connect 入口
也就是说,即使是 Jellyfin 和 Emby 共用同一个 MediaBrowser 协议栈,JellyBox 也能自动分辨出该用哪套认证流程。
多账号管理:一次登录,永久保存
添加第一台服务器后,你随时可以再添加第二台、第三台。所有账号保存在本地列表中(见 account_store.dart),当前激活的服务器由 currentServerId 标识。
切换逻辑在 auth_provider.dart 的 switchTo 方法中实现:切换到另一台已保存的服务器时,它会先释放当前连接,再从本地凭据直接恢复目标会话(_restoreSession),不会要求你重新输入密码。
一键切换步骤
- 打开 App,点击顶部的服务器/账号区域,弹出已保存的服务器列表(组件见 server_accounts.dart)
- 点击目标服务器,JellyBox 自动完成会话恢复
- 该服务器自己的播放队列、最近播放也会随之还原
在多音乐库的服务器上,还可以继续通过库选择器(library_selector_button.dart)在同一个服务器内的不同音乐库之间切换。
切换时播放体验不断层
很多客户端"换服务器"意味着播放全丢,JellyBox 在这方面做了专门处理:
- 队列记忆:App 重启后仍会恢复上次的队列和播放位置(
_restoreQueue会在切换完成后自动触发) - 独立流媒体配置文件:每台服务器连接都有自己的 streaming profile,如果服务器不支持原生解码,会自动转码
- 音质徽章:界面上始终显示当前是否播放的是原始文件,多服务器场景下不会混淆
- 播放记忆跨服务器:换到第二台服务器时,第一台的进度不丢失,切回来继续
多服务器之外,这些能力同样通用
无论你连接的是 Jellyfin、Emby 还是 Navidrome,以下功能开箱即用:
- 🔎 全局搜索专辑、歌手、歌曲、歌单,也可按类型过滤
- 📜 时间轴同步歌词
- ⬇️ 专辑/单曲离线下载,支持飞行模式离线模式
- 🚗 Apple CarPlay 与 Android Auto(Beta)
- 📺 投屏到 DLNA / UPnP 设备(智能电视、网络音箱)
- 🎨 主题色跟随专辑封面自动提取,附带全屏 Studio Mode
常见问题
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,它就是那个把自托管音乐库"流媒体化"的播放器。


