MoviePilot是一款专为NAS设计的开源媒体库自动化管理工具，能够自动完成影视资源下载、智能整理、元数据刮削和订阅追踪。支持Docker一键部署，完美适配群晖、威联通等主流NAS设备，配合Jellyfin/Emby/Plex打造精美海报墙，让家庭影院管理从此省心省力。

🎤 引言

你有没有这种经历？下载了一堆电影电视剧，结果文件名乱七八糟，海报信息全都没有，在播放器里就是一坨坨冷冰冰的文件名。手动整理吧，几百部片子能整到怀疑人生；不整理吧，看着那一堆"xxx.1080p.WEB-DL.DDP5.1.x264-Group.mkv"就头大。

MoviePilot 就是来解决这个问题的。它基于 NAStool 重新设计，专门做一件事：让你的 NAS 媒体库实现全自动管理。从下载、整理、刮削到订阅，全程不用你动手。

⭐ 核心功能

1. 自动下载与订阅

MoviePilot 支持对接多种下载工具（qBittorrent、Transmission、Aria2 等），配合 PT 站点或 BT 站点使用。你只需要在 Web 界面搜索想看的电影或剧集，剩下的交给它。

支持的功能包括：

  • RSS 订阅：自动监控订阅源的更新
  • 站点搜索：聚合多个站点的搜索结果
  • 智能下载：根据分辨率、编码、字幕等规则自动筛选最佳资源

2. 媒体整理与重命名

下载完成后，MoviePilot 会自动：

  • 识别电影/剧集信息（通过 TMDB、豆瓣等数据源）
  • 按规则重命名文件（支持自定义命名模板）
  • 移动到指定目录并创建规范的文件夹结构

比如下载的原始文件名是：

The.Matrix.1999.1080p.BluRay.x264.DTS-WiKi.mkv

整理后变成：

/媒体库/电影/黑客帝国 (1999)/黑客帝国 (1999) - 1080p.mkv

3. 自动刮削与海报下载

MoviePilot 会自动从 TMDB、豆瓣等数据源获取：

  • 电影/剧集的基本信息（名称、年份、简介、评分）
  • 海报、背景图、剧照
  • 演员信息、导演、类型标签

刮削后的数据可以直接被 Jellyfin、Emby、Plex 等播放器识别，呈现精美的海报墙效果。

4. 多平台播放器支持

整理好的媒体库可以直接对接：

  • Jellyfin：开源免费，推荐首选
  • Emby：功能强大，部分高级功能收费
  • Plex：生态完善，有付费版本
  • Kodi：本地播放器，适合电视盒子

📥 安装与使用

Docker 部署（推荐）

MoviePilot 提供官方 Docker 镜像，支持 x86_64 和 ARM64 架构。以下是最小化部署配置：

version: '3.3'
services:
  moviepilot:
    image: jxxghp/moviepilot:latest
    container_name: moviepilot
    restart: always
    network_mode: host
    volumes:
      - '/你的媒体目录:/media'
      - './config:/config'
      - './core:/moviepilot/.cache/ms-playwright'
    environment:
      - 'NGINX_PORT=3000'
      - 'PORT=3001'
      - 'PUID=0'
      - 'PGID=0'
      - 'UMASK=000'
      - 'TZ=Asia/Shanghai'
      - 'SUPERUSER=admin'
      - 'SUPERUSER_PASSWORD=你的密码'

启动后访问 http://NAS_IP:3000，用设置的账号密码登录即可。

群晖套件安装

对于群晖用户，可以通过矿神套件源直接安装：

  1. 添加套件源：https://spk.imnks.com
  2. 搜索安装 MoviePilot
  3. 默认端口：13000
  4. 初始密码在配置目录查看

这种方式最简单，不需要折腾 Docker。

基础配置

首次使用需要配置几个关键项：

媒体库路径：

  • 电影目录：/media/电影
  • 剧集目录：/media/电视剧
  • 下载目录：/media/下载

下载器设置：

  • qBittorrent：填写地址、端口、用户名、密码
  • Transmission：同上
  • 支持通过 Web UI 直接添加下载任务

索引器配置：

  • 添加 PT/BT 站点
  • 配置站点 Cookie 或 API Key
  • 支持 Jackett/Prowlarr 聚合

通知设置（可选）：

  • Telegram Bot
  • 企业微信
  • 钉钉
  • Bark

⚠️ 注意事项

1. 版本差异

MoviePilot 分为 v1 和 v2 两个版本：

  • v1：功能稳定，文档齐全，适合新手
  • v2：重构版本，功能更强，但配置方式有变化

建议新手从 v1 开始，熟悉后再考虑升级 v2。

2. 权限问题

Docker 部署时要注意文件权限：

  • PUID 和 PGID 建议设置为 NAS 用户的实际 UID/GID
  • 媒体目录需要给容器读写权限
  • 下载目录和整理目录最好在同一个文件系统内（避免跨盘复制）

3. 刮削失败

如果自动刮削不准确，可以：

  • 在 Web UI 手动搜索匹配
  • 调整文件命名规则
  • 使用自定义 TMDB ID 强制匹配

4. 资源占用

MoviePilot 运行时需要：

  • 内存：至少 1GB，建议 2GB+
  • 存储：配置文件约 500MB，日志文件会持续增长
  • CPU：刮削时会有短暂高占用

✅ 总结

MoviePilot 适合以下场景：

  • 有 NAS 设备，想搭建家庭影院
  • 下载了大量影视资源，需要自动整理
  • 使用 Jellyfin/Emby/Plex 等播放器
  • 希望实现订阅追剧的自动化

它的核心优势是一站式解决：从下载到整理到刮削，全程自动化。相比手动管理，能节省大量时间。

当然，它也不是万能的。如果你的资源命名极其混乱，或者下载的是冷门小众内容，可能需要手动干预。但总体来说，对于主流影视资源，MoviePilot 的自动识别率已经相当高了。

开源地址：github.com/jxxghp/MoviePilot

如果你正在折腾 NAS 媒体库，值得一试。