MoviePilot 负责识别、搜索、订阅、下载调度与文件整理;下载器负责获取文件,媒体服务器负责扫描、展示和播放。第一次使用,先以一部已知电影或一集电视剧完成整个流程,确认路径正确后再扩大范围。
| 场景 | 最少需要准备 |
|---|---|
| 只整理已有文件 | MoviePilot、可访问的源目录和媒体库目录、可用的元数据网络 |
| 搜索和下载站点资源 | 再准备可用站点、用户认证、下载器 |
| 自动追更和避免重复下载 | 再连接媒体服务器,核对库存与订阅规则 |
| 使用 AI、网盘或远程通知 | 基础流程正常后按需增加,分别测试 |
http://服务器地址:3000。V3 Web 首次初始化时创建管理员用户名、密码和 API Key,随后登录。不要按 V1、V2 的旧截图在日志中寻找随机管理员密码。旧实例继续使用原配置目录。不要为升级新建一个空
/config后误以为数据丢失,也不要让两个 MoviePilot 实例同时写同一份数据库。
一个容易排查的同盘示例:
/media/
├── downloads/ 下载器保存文件
└── library/ MoviePilot 整理后的文件
├── movies/
└── tv/
/media。设定 → 目录 中,将下载目录和媒体库目录分别指向上述实际路径,并选择媒体类型、整理方式和监控方式。完整的同机、远程下载器和不同路径示例见目录与路径。
设定 → 连接 → 下载器 添加下载器,启用并选择默认项,测试连接。localhost 指当前容器,不是宿主机或另一容器。仅做文件整理可以先跳过下载器;尚未部署媒体服务器时可以先验证文件落盘,但不能据此确认媒体库查重与播放链路。
在头像菜单的 用户认证 中选择当前支持的认证站点,并按提示填写参数。认证站点的可用范围以当前资源和界面为准。
然后在站点管理中添加用于搜索、订阅的站点,维护 Cookie、API Key 或该站需要的其他参数,进行连通性测试。用户认证通过与某个站点能搜索、能下载是不同检查;其中一项成功不代表另一项已经配置好。
浏览器同步 Cookie 的方法见站点。不要将 Cookie、Passkey 或完整下载链接贴进公开问题反馈。
这五步分别验证不同环节。“下载提交成功”不是下载完成,“整理入队”不是已经入库,“整理成功”也不代表媒体服务器已完成扫描。
| 需要的效果 | 接下来配置 | 如何确认 |
|---|---|---|
| 下载完成后整理 | 目录的下载器监控,或合适的目录监控 | 一次下载完成后出现成功整理记录 |
| 持续追更、补缺 | 订阅与过滤规则 | 查看订阅进度、刷新活动与下载记录 |
| 按电影、剧集、音乐分目录 | 自动分类 | 预览分类并检查目标目录 |
| 下载、入库后收到消息 | 通知 | 测试消息与真实业务消息均能收到 |
| 多个动作按顺序执行 | 工作流 | 先手动执行一个小范围流程 |
| 手机管理与桌面信息 | iOS 与 PWA | 真机连接、权限与通知分别测试 |
遇到问题时从故障排除按失败环节检查,先保留日志和记录,再调整配置。