MoviePilot 向下载器提交资源并查询进度,实际网络下载与做种由下载器完成。当前内置下载器类型包括 qBittorrent、Transmission、rTorrent;插件还可以扩展其他类型,实际可选项以实例界面为准。
在 设定 → 连接 → 下载器 中维护连接。先连接一个实例并验证下载、完成、整理全过程,再增加多下载器分流。
| 项目 | 检查方法 |
|---|---|
| 下载器已启用远程管理接口 | 按下载器自己的说明启用 Web API 或 RPC |
| 地址对 MoviePilot 可达 | 按容器网络、局域网或 VPN 选择地址 |
| 认证信息正确 | 使用下载器的接口账号,不是 MoviePilot 登录账号 |
| 下载目录已持久化 | 下载器容器重建后文件仍在 |
| 源文件对 MoviePilot 可读 | 在文件管理中核对,必要时先配置存储和映射 |
同一个 Compose 网络内可使用服务名,例如 http://qbittorrent:8080。下载器部署在另一台设备时填写该设备可达的地址;不要照抄容器内的 127.0.0.1。
qBittorrent 的分类、顺序下载等选项,以及 Transmission 的未完成文件命名等选项,会随类型显示。只配置对应类型支持的字段;“连接成功”不能证明保存目录和整理配置也正确。
MoviePilot 的下载目录来自目录配置与具体业务选择,最终发送给下载器的路径必须符合下载器视角。
/media:优先使用一致路径。详细示例见目录与路径。
目录配置选择下载器监控后,MoviePilot 会检查已完成任务并进入整理流程。请同时核对:
下载器已经完成但一直不整理时,先检查这些条件,再查看故障排除。不要用重复添加同一个下载任务来触发整理。
为不同用途的下载器使用清晰名称,例如“本地下载”和“远程下载”。新增实例后检查默认项,测试时明确记录使用的实例。
开始、暂停、删除、校验、移动保存目录等动作会真实作用于下载器。删除时尤其要区分“只删除任务”与“同时删除文件”;仍在做种的任务不要随意移动源文件。需要删除整理结果时,另外核对媒体库文件和硬链接关系。
| 现象 | 优先检查 |
|---|---|
| 网页能打开,MoviePilot 连接失败 | 两者所在网络、API 路径、认证和 HTTPS 证书是否一致 |
| 返回未授权或禁止访问 | 下载器账号、RPC/Web API 权限、来源限制与反向代理 |
| 任务有了但文件不在预期位置 | 下载器实际保存目录、分类规则、MoviePilot 路径转换 |
| 下载完成后找不到文件 | 两边是否真指向同一批文件,远程共享是否挂载 |
| 有多个下载器,任务去了另一台 | 默认实例、订阅/工作流指定项与本次下载选项 |
| 整理成功但无法继续做种 | 是否使用移动、改写了源文件,或下载器路径失效 |