| 路径 | 谁使用 | 作用 |
|---|---|---|
| 宿主机路径 | NAS、Linux、macOS 文件系统 | 真实存储位置,例如 /mnt/media |
| 下载器路径 | qBittorrent、Transmission、rTorrent | 任务保存位置,例如 /downloads |
| MoviePilot 存储路径 | MoviePilot 容器或本地进程 | 读取源文件与写入媒体库,例如 /media/downloads |
容器映射 宿主机目录:容器目录 决定进程能看到什么。MoviePilot 设置里的本地路径应按 MoviePilot 内部视角填写;下载器实际接收的路径须符合下载器视角。双方不同,可以通过下载器路径映射建立对应关系。
假设宿主机真实目录如下:
/mnt/media/downloads
/mnt/media/library/movies
/mnt/media/library/tv
让 MoviePilot 和下载器都挂载同一个共同根目录:
# 分别添加到 MoviePilot 和下载器各自的服务配置中
volumes:
- /mnt/media:/media
两边均使用 /media/downloads 作为下载位置,MoviePilot 的媒体库目标使用 /media/library/movies、/media/library/tv。这类配置通常不需要额外路径映射。
共同目录只是路径层面的条件。硬链接还要求源文件与目标目录在同一文件系统,且运行用户有权限;不同磁盘、存储池、共享协议或挂载点不能仅靠改写路径解决。
假设下载器中同一文件为 /downloads/Example.mkv,MoviePilot 中为 /media/downloads/Example.mkv:
| 下载器配置中的字段 | 填写值 |
|---|---|
| 存储路径 | /media/downloads |
| 下载路径 | /downloads |
在 设定 → 连接 → 下载器 → 路径映射 中填写。MoviePilot 通过它在存储路径与下载器路径之间转换,前后缀应指向同一批文件。
检查时选一个真实完成文件:下载器返回路径转换后,必须能在 MoviePilot 的文件管理中找到该文件,而不是只看到一个同名空目录。多条映射应各自覆盖明确的目录范围,避免互相冲突。
下载器不在 MoviePilot 同一台机器时,还需要让 MoviePilot 能访问其文件:
路径映射不挂载共享、不同步文件,也不会让两台机器获得跨机硬链接能力。需要通过网络读写的场景见存储与文件管理。
目录配置可以同时包含下载目录、媒体类型、固定分类、监控方式、整理方式、覆盖模式、媒体库存储与媒体库目录。
复杂配置前先建立电影、电视剧各一条可工作的目录,再逐步拆分动漫、不同存储和音乐目录。
| 方式 | 源文件 | 空间与条件 | 适用场景 |
|---|---|---|---|
| 移动 | 成功后离开原位置 | 不适合仍依赖原路径做种的任务 | 不需保留源文件 |
| 复制 | 保留 | 通常占用另一份文件空间 | 跨盘、跨设备或希望独立保留 |
| 硬链接 | 保留 | 同一文件系统;共享同一文件内容 | 保留下载位置继续做种 |
| 软链接 | 保留 | 目标引用源路径,播放器也要能解析 | 明确了解路径与生命周期的场景 |
| Reflink | 保留 | 需要文件系统与实际存储支持 | 希望写时复制的本地存储 |
硬链接的两个名称指向同一份内容,直接改写其中一份文件内容会影响另一份;删除其中一个名称不会自动删除另一个。不要把硬链接理解为两份独立备份。
PUID、PGID、共享目录权限和 NAS ACL 都可能影响读写。应在运行 MoviePilot 的身份下核对,不以宿主机管理员能打开文件作为唯一依据。在文件管理中找到一个样本,进入手动整理,先查看预览中的源路径、目标路径、媒体身份与文件名。确认后实际整理,再分别检查源文件、目标文件、整理历史和媒体服务器扫描。
预览验证的是计划;权限变化、网络故障、磁盘空间或同名目标都可能影响实际执行。完整说明见文件整理。