通过 Emby、Jellyfin、Plex 进行串流

连接 Emby、Jellyfin、Plex 媒体服务器播放影片，并同步播放进度与观看记录。

如果你已经跑着 Emby、Jellyfin 或 Plex 服务器，那么恭喜 —— 这是最省心的方式：服务端已经刮削好了元数据，播放器直接取用即可。

除了这三家，月光放映机也支持连接极空间。

支持的能力

连接媒体服务器后，你可以：

• 浏览服务器上的媒体库（电影 / 剧集 / 动漫等分类）
• 直接使用服务端已刮削的元数据（海报、简介、演员）
• 同步播放进度到服务器，换设备继续看
• 同步观看记录，已看过的剧集有标记
• 选择不同清晰度 / 版本播放
• 播放服务器上的季集与播放列表

添加媒体服务器

1. 首页点「+」→「添加文件源」
2. 在「媒体服务器」里选择 Emby / Jellyfin / Plex
3. 填写服务器信息：

4. 保存后应用会自动登录并获取令牌

元数据以服务器为准

和 NAS、网盘最大的区别：连接媒体服务器时，影片信息完全来自服务器，不会再去 TMDB 刮一遍。

好处是：

• 服务器上已经整理好的中文标题、分类、合集都会原样呈现
• 服务端新增或删除影片，播放器刷新一下就能看到
• 不需要在设备上缓存整个库，设备存储占用很小

播放进度同步

播放过程中的进度会实时上报到媒体服务器：

• 在手机上看到一半，转到平板打开同一集，会从断点继续
• 服务器上其他客户端（如电视端 Emby App）也能看到进度
• 看完一集后，该集在服务器上被标记为已观看

这是通过 Emby / Jellyfin 的 Sessions / Playing 系列接口完成的，因此需要在服务器上保持会话有效。如果长时间不播放，令牌可能过期，重新进入文件源时应用会自动重新认证。

连接信息与排错

部分服务器管理员会通过 User-Agent 或客户端标识来做路由、限流或统计。月光放映机会带上：

• 统一的 User-Agent：MoonPlay/<版本名> (<版本号>; HarmonyOS)
• Emby / Jellyfin：X-Emby-Authorization 头，携带 Client、Device、DeviceId、Version、Token
• Plex：X-Plex-Product、X-Plex-Client-Identifier、X-Plex-Version、X-Plex-Device-Name、X-Plex-Platform 等头

具体头信息格式见Emby、Jellyfin 和 Plex 的连接信息。

常见问题

登录失败 / 提示账号密码错误

• Jellyfin 只能用服务器本地账号登录，不能用 Emby 的在线账号
• Emby 和 Plex 支持在线账号，但内网服务器如果没连外网，仍然要用本地账号
• 确认账号有权限访问目标媒体库

看不到某个媒体库

默认会扫描服务器上所有可见的媒体库。如果某个库没出现：

• 确认该账号在该库上有访问权限（在服务端设置里检查）
• 部分服务器会隐藏「未分类」的内容

远程访问连不上

• 确认服务器的远程访问功能已开启（Plex 在设置 → 远程访问）
• 检查路由器端口转发 / 反向代理配置
• Plex 的中继（Relay）服务带宽上限较低，用它播放会卡，建议直连

播放进度没同步

• 确认服务器地址填的是同一个（别一个填内网 IP、一个填域名，会被识别为两台服务器）
• 检查服务器上的该用户是否为当前登录用户
• 换网络环境后令牌可能失效，到文件源里重新登录一次

相关阅读

• 从 NAS 进行串流
• 从网盘进行串流