媒体服务器负责扫描文件、展示媒体库和播放。MoviePilot 通过连接读取库存,用于查重、订阅补缺、首页卡片和播放跳转;整理完成后还可发起库刷新。
当前内置类型包括 Emby、Jellyfin、Plex、极影视、飞牛影视、绿联影视、Navidrome、Vyo。不同服务支持的库存、音乐、扫描和播放能力并不完全相同,实际配置项以所选类型为准。
设定 → 连接 → 媒体服务器 添加实例并启用。服务端连接地址必须让 MoviePilot 能访问;用于用户播放跳转的地址还需要让 用户设备 能访问。容器服务名可用于后端通信,但手机通常不能直接解析该服务名。
| 动作 | 方向 | 作用 |
|---|---|---|
| 库存同步 | 媒体服务器 → MoviePilot | 更新 MoviePilot 保存的媒体库信息 |
| 扫描或刷新 | MoviePilot → 媒体服务器 | 请求媒体服务器发现新增或变更文件 |
| 播放入口 | MoviePilot → 播放器或网页 | 跳转到媒体服务器已有条目,不代替服务器播放 |
| 文件整理 | 源存储 → 媒体库目录 | 生成目标文件,不保证服务器已扫描完成 |
因此“文件已经整理成功,但 MoviePilot 仍显示未入库”时,应先确认服务器已经扫描到该文件,再更新库存;不要直接关闭查重。
MoviePilot V3 以 media_source + media_id 表达媒体身份。电影、电视剧还要结合类型、季集等信息;只有名称相似不足以证明是同一部媒体。
已有文件未被认出时,检查媒体服务器刮削出的来源 ID、年份、类型、季集编号是否正确。多版本、特别篇、动漫累计集号或不同来源的条目,需要先确认对应关系,再决定是否补下或重新整理。
暂停订阅不会暂停已经交给下载器的任务;同样,媒体库暂时不可达也不等于需要重新下载全部内容。订阅行为见订阅。
音乐文件由 MoviePilot 整理和刮削后,交给支持音乐的媒体服务器扫描。Navidrome 是当前内置音乐服务器类型之一;不要将仅支持影视的服务默认当成音乐库使用。
请分别验证专辑、曲目、艺术家信息和文件路径。歌曲版次、专辑版次与已有曲目完整性会影响查重,不能只看专辑标题。音乐的支持范围见音乐。
需要接收播放或库事件时,可按服务端插件能力配置 MoviePilot Webhook。回调地址与认证要求见外部集成。
Webhook 是服务器主动发给 MoviePilot 的事件,与 MoviePilot 定时读取库存不是同一件事;配置回调前先完成基本连接与同步。多实例回调应携带正确的来源名称。
底层查询合同与各服务限制见主仓媒体服务器查询文档。