外观
MoviePilot：媒体库自动化整理
把「找资源 → 下载 → 重命名 → 移动到媒体库 → 通知媒体服务器刷新」这条链路自动化。它本身不提供任何资源，只是调度你已经配置好的下载器和站点。
使用前请确认合规
这类工具通常与 BitTorrent 站点对接。请只用于你有权获取的内容，并遵守所在地区的法律法规和站点规则。本站不提供站点邀请、资源获取或任何规避版权保护的方法。
适合谁
- 已经有成规模的媒体库，手动整理命名占用太多时间。
- 追剧需求稳定，希望新一集出来自动处理。
不适合：片量不大、偶尔看一部的人。这套链路的配置和维护成本不低，出问题时排查链路也长（订阅、站点、下载器、文件整理、媒体服务器，任何一环都可能断）。
部署要点
项目迭代较快，镜像名称、版本标签和必需的环境变量都可能变化。请以官方仓库的当前说明为准，不要照抄网上的旧配置。
部署时需要提前准备好的信息：
| 项目 | 说明 |
|---|---|
| 超级管理员账号密码 | 首次启动时通过环境变量设置 |
| 下载器地址与凭据 | 例如 qBittorrent 的网页端 |
| 媒体服务器地址与 API 密钥 | 飞牛影视、Jellyfin 或 Emby |
| 目录映射 | 下载目录和媒体库目录在容器内外要保持一致 |
目录映射不一致会导致文件被误移动
MoviePilot 需要在下载目录和媒体库目录之间移动或硬链接文件。如果容器内看到的路径与下载器看到的路径不一致，它会找不到文件，或者把文件放到错误的位置。部署前先把路径规划画出来，让下载器和 MoviePilot 看到的是同一套路径。
硬链接与存储空间
文件整理推荐用硬链接而不是复制：同一份数据在下载目录和媒体库目录各有一个入口，不占用双倍空间，做种也不受影响。
前提是两个目录必须在同一个存储空间（同一个文件系统）内。跨存储空间无法创建硬链接，会退化成复制，空间直接翻倍。这是规划目录时最容易忽略的约束。
数据与备份
配置目录里包含站点凭据、订阅规则和历史记录，属于敏感数据。备份它，并注意这份备份本身也要保护好。
已知坑
- 链路长，出问题要逐段排查：订阅有没有抓到、下载器有没有收到任务、文件有没有被整理、媒体服务器有没有刷新。
- 自动重命名一旦规则配错，可能批量改乱已有文件。先用少量测试文件验证规则，不要直接对全库开跑。
- 持续的下载和整理会让硬盘无法休眠，见功耗与硬盘休眠。