MoviePilot 使用指南

MoviePilot 是一款强大的自动化影视管理工具，可以自动搜索、下载、整理和管理您的影视资源。本指南将详细介绍如何使用 MoviePilot 的各项功能。

快速入门

1. Docker 部署 MoviePilot

bash

docker run -d \
  --name moviepilot \
  -p 3000:3000 \
  -v /path/to/config:/config \
  -v /path/to/downloads:/downloads \
  -v /path/to/media:/media \
  -e TZ=Asia/Shanghai \
  -e PUID=1000 \
  -e PGID=1000 \
  jxxghp/moviepilot:latest

卷说明:

/config - MoviePilot 配置文件目录
/downloads - 下载目录 (与 qBittorrent/Transmission 共享)
/media - 媒体库目录 (与 Plex/Jellyfin 共享)

2. 初始配置

访问 http://your-nas-ip:3000 进入 MoviePilot 管理界面:

创建管理员账户
- 设置用户名和密码
- 记录并妥善保管
配置下载器
- 添加 qBittorrent 或 Transmission
- 测试连接确保正常
配置媒体服务器
- 连接 Plex 或 Jellyfin
- 设置媒体库扫描路径
配置索引器
- 添加 PT 站或公网索引器
- 配置 Cookie 或 API Key

搜索功能

基础搜索

图：MoviePilot 搜索主界面，支持关键词搜索和质量筛选

访问搜索页面
- 点击顶部导航栏的"搜索"按钮
- 或直接访问 /search 路径
输入关键词
- 支持中文、英文片名
- 支持演员、导演名字
- 支持年份筛选
搜索结果
- 显示所有匹配的资源
- 显示种子大小、做种数、发布者信息
- 支持按质量、大小、时间排序

图：搜索结果页面，显示资源详情和操作按钮

高级搜索技巧

1. 精确搜索

流浪地球 2 2023

使用完整片名 + 年份，减少无关结果

2. 系列搜索

Marvel OR 漫威

使用逻辑运算符搜索多个关键词

3. 过滤低质量

勾选"仅显示高清"
设置最小文件大小 (如 1GB)
排除特定发布组

图：高级搜索过滤选项，可设置质量、大小等条件

4. 批量选择

按住 Ctrl/Cmd 多选
一次性下载整季内容

搜索示例

示例 1: 搜索最新电影

操作步骤:
1. 点击"搜索" → 输入"奥本海默 2023"
2. 筛选"4K"质量
3. 选择体积合适的种子 (推荐 20-50GB)
4. 点击下载，自动发送到下载器

示例 2: 搜索美剧

操作步骤:
1. 搜索"最后生还者"
2. 选择剧集 S01E01-E09
3. 批量添加到下载队列
4. 下载完成后自动刮削元数据

订阅管理

创建订阅

方法 1: 手动创建

图：手动创建订阅表单，填写影片信息

点击"订阅" → "新建订阅"
填写信息:
- 名称: 流浪地球 2
- 类型: 电影/电视剧
- 年份: 2023
- 质量: 4K/1080p (可选)
- 优先级: 高/中/低
点击"保存"

方法 2: 从搜索创建

搜索目标影片
点击结果页面的"🔔 订阅"按钮
自动填充信息，确认即可

订阅监控

MoviePilot 会定期检查订阅状态:

检查频率: 每 30 分钟 (可配置)
自动下载: 发现新资源立即开始下载
智能过滤: 根据质量要求自动选择最佳版本

图：订阅列表页面，显示各订阅项的状态

订阅列表操作:

操作	说明
✅ 完成	已下载完成，移至媒体库
⏳ 等待中	正在等待资源发布
⬇️ 下载中	正在下载
❌ 失败	无可用资源或下载失败

订阅管理技巧

1. 批量管理

批量删除已完成订阅
批量暂停/启用订阅

2. 优先级调整

高优先级 → 优先搜索和下载
中优先级 → 正常排队
低优先级 → 有空闲带宽时下载

3. 订阅通知

开启微信/Telegram 推送
新集下载完成即时通知
订阅状态变更提醒

4. 智能订阅

yaml

# 高级用户可配置自定义规则
subscription_rules:
  - name: "只下载 4K"
    condition: "resolution == '2160p'"
  
  - name: "排除特定发布组"
    condition: "release_group not in ['bad_group']"
  
  - name: "最小体积限制"
    condition: "size >= 10GB"

订阅实战案例

案例 1: 追更美剧

场景: 《权力的游戏》每周日更新

配置步骤:
1. 搜索"权力的游戏"
2. 创建电视剧订阅
3. 选择"最新季"(Season 8)
4. 设置质量"1080p"
5. 开启"自动下载"
6. 绑定 Telegram 通知

效果:
- 每周一早上自动下载最新集
- 手机收到推送通知
- 晚上可直接观看

案例 2: 收藏经典电影

场景: 收集周星驰经典电影

配置步骤:
1. 创建电影订阅"周星驰"
2. 设置质量"4K + 1080p"
3. 开启"合集模式"
4. 设置存储空间上限 500GB

效果:
- 自动搜索所有相关电影
- 优先下载高质量版本
- 达到空间上限后停止

下载配置

下载器集成

qBittorrent 配置:

图：在 MoviePilot 中配置 qBittorrent 下载器

yaml

下载器设置:
  地址：http://nas-ip:8080
  用户名：admin
  密码：your_password
  
分类设置:
  电影：/downloads/movies
  剧集：/downloads/tvshows
  动漫：/downloads/anime
  
限速策略:
  工作时间：上传 5MB/s, 下载 10MB/s
  非工作时间：不限速

Transmission 配置:

yaml

下载器设置:
  地址：http://nas-ip:9091
  用户名：transmission
  密码：your_password
  
下载路径:
  默认：/downloads/complete
  未完成：/downloads/incomplete

下载策略

1. 智能限速

工作时间 (9:00-18:00):
- 下载限速：10 MB/s
- 上传限速：5 MB/s

空闲时间 (18:00-次日 9:00):
- 取消限速，全速下载

2. 自动分类

电影 → /media/movies
电视剧 → /media/tvshows
动漫 → /media/anime

图：下载任务管理界面，显示进度和分类

3. 做种设置

yaml

做种规则:
  最小做种时间：24 小时
  最小分享率：1.0
  达到条件后：自动停止

媒体库管理

自动整理

MoviePilot 下载完成后会自动:

文件重命名

原始：Movie.Name.2023.2160p.WEB-DL.x265.AAC.mkv
重命名：流浪地球 2 (2023)/流浪地球 2 (2023).mkv

移动到媒体库

/downloads/movies/xxx.mkv → /media/movies/xxx.mkv

刮削元数据
- 下载海报、背景图
- 抓取剧情简介、演职员表
- 生成 NFO 文件

图：下载完成后自动整理到媒体库的流程图

媒体库同步

Plex 配置:

图：在 Plex 中配置媒体库路径和刮削器

1. 打开 Plex Web 界面
2. 设置 → 管理 → 媒体库
3. 添加库 → 选择对应文件夹
4. 设置代理 → The Movie Database
5. 扫描媒体库

Jellyfin 配置:

图：在 Jellyfin 中配置媒体库

1. 控制台 → 媒体库
2. 添加媒体库 → 选择类型
3. 选择文件夹路径
4. 配置元数据抓取器
5. 扫描

媒体库展示

最终效果示例:

图：Plex 媒体库最终展示效果，包含海报墙和详细信息

媒体库维护

定期清理:

bash

# 每月执行一次
find /media -name "*.nfo" -mtime +30 -delete
find /media -name "*.jpg" -mtime +30 -delete

手动刷新:

Plex: 库 → 刷新全部元数据
Jellyfin: 仪表盘 → 刷新元数据

常见问题

Q1: 搜索不到资源？

解决方案:

检查索引器配置是否正确
尝试更换关键词 (中英文交替)
降低质量要求 (4K→1080p)
检查 PT 站账号是否失效

Q2: 订阅一直不下载？

排查步骤:

查看是否有可用资源
检查下载器连接状态
确认存储空间充足
查看日志定位具体错误

Q3: 下载速度慢？

优化建议:

选择做种数多的种子
避开高峰时段
提升 PT 站等级获取更多权限
检查网络带宽占用

Q4: 媒体库不识别？

解决方法:

确认文件命名规范
手动刷新媒体库
检查刮削器配置
查看 Plex/Jellyfin日志

Q5: 如何备份配置？

备份步骤:

bash

# 备份配置目录
tar -czf moviepilot_backup.tar.gz /path/to/config

# 还原配置
tar -xzf moviepilot_backup.tar.gz -C /path/to/

进阶技巧

1. 自定义脚本

在 /config/plugins 目录下创建 Python 脚本实现自动化:

python

# 示例：自动删除低质量版本
def delete_low_quality():
    # 查找所有低于 720p 的文件
    # 移动到回收站
    pass

2. Webhook 集成

配置 Webhook 实现事件通知:

yaml

webhooks:
  download_complete: https://your-server.com/webhook
  subscription_added: https://your-server.com/webhook

3. API 调用

通过 API 实现程序化控制:

bash

# 获取订阅列表
curl http://nas-ip:3000/api/v1/subscriptions \
  -H "Authorization: Bearer YOUR_TOKEN"

# 创建订阅
curl -X POST http://nas-ip:3000/api/v1/subscriptions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Movie Name","year":2023}'

总结

MoviePilot 是 NAS 影视管理的核心工具，掌握它能极大提升使用体验:

✅ 自动化: 从搜索到播放全流程自动化
✅ 智能化: 根据偏好自动选择最佳版本
✅ 便捷性: 统一管理所有影视资源
✅ 扩展性: 支持插件和自定义脚本

建议新手从基础功能开始，逐步掌握高级用法，打造属于自己的自动化影视库!

MoviePilot 使用指南 ​

目录 ​

快速入门 ​

1. Docker 部署 MoviePilot ​

2. 初始配置 ​

搜索功能 ​

基础搜索 ​

高级搜索技巧 ​

搜索示例 ​

订阅管理 ​

创建订阅 ​

订阅监控 ​

订阅管理技巧 ​

订阅实战案例 ​

下载配置 ​

下载器集成 ​

下载策略 ​

媒体库管理 ​

自动整理 ​

媒体库同步 ​

媒体库展示 ​

媒体库维护 ​

常见问题 ​

Q1: 搜索不到资源？ ​

Q2: 订阅一直不下载？ ​

Q3: 下载速度慢？ ​

Q4: 媒体库不识别？ ​

Q5: 如何备份配置？ ​

进阶技巧 ​

1. 自定义脚本 ​

2. Webhook 集成 ​

3. API 调用 ​

总结 ​

MoviePilot 使用指南

目录

快速入门

1. Docker 部署 MoviePilot

2. 初始配置

搜索功能

基础搜索

高级搜索技巧

搜索示例

订阅管理

创建订阅

订阅监控

订阅管理技巧

订阅实战案例

下载配置

下载器集成

下载策略

媒体库管理

自动整理

媒体库同步

媒体库展示

媒体库维护

常见问题

Q1: 搜索不到资源？

Q2: 订阅一直不下载？

Q3: 下载速度慢？

Q4: 媒体库不识别？

Q5: 如何备份配置？

进阶技巧

1. 自定义脚本

2. Webhook 集成

3. API 调用

总结