MP是一款基于 Python + Docker 的智能影视自动化管理系统，由原 NasTools 作者开发，聚焦核心自动化需求，支持自动搜片、下载、整理、刮削元数据，并可与 Emby、Jellyfin、Plex 等媒体服务器无缝联动，实现家庭影院“无人值守”运转。本教程专为飞牛NAS和群晖NAS用户定制，包含完整安装流程、依赖配置及常见问题解决，关键步骤配套图片指引，确保新手也能顺利上手。

一、安装前通用准备

无论使用哪种NAS，安装前需完成以下基础准备，避免后续操作出错：

1. 硬件与系统要求：NAS 需支持 Docker 功能（飞牛NAS需升级至最新 fnOS 系统，群晖NAS需 DSM 7.0 及以上版本）；建议预留至少 10GB 存储空间（含镜像及配置文件）。
2. 依赖服务部署：
   1. 下载器：提前安装 qBittorrent（推荐，版本 ≥ 4.3.9）或 Transmission（版本 ≥ 3.0），用于资源下载。
   2. 媒体服务器：可选安装 Emby、Jellyfin、Plex 或飞牛影视，用于影视文件播放与管理。
   3. CookieCloud：MP 核心依赖，用于同步浏览器站点 Cookie，需安装插件及可选的自建服务端。
3. 基础信息确认：记录 NAS 的局域网 IP 地址（后续访问管理界面需使用）；确保 NAS 已连接外网，可正常拉取 Docker 镜像。

二、飞牛NAS安装教程

飞牛NAS推荐通过 Docker Compose 脚本安装，步骤简洁且配置可复用，适合批量部署相关服务（如 qBittorrent + MP 或者Transmission+MP等联动）。

步骤1：启用 Docker 功能

1. 登录飞牛NAS管理界面，进入「docker」，看看是否开启这个。
2. 确认 Docker 服务正常启动（界面无报错即可）。

步骤2：创建目录结构

为避免配置文件混乱，提前创建统一的目录用于存储 MP 程序文件、配置及影视资源：

1. 进入飞牛NAS「文件管理」，在默认存储卷（通常为 /vol1/1000/ 或 /vol1/1001/）下创建以下目录：
   1. docker/MP：用于存储 MoviePilot 程序主目录和配置文件【这个目录可以自定义创建】
   2. video：用于存储下载的影视资源（可细分 movie（电影文件夹）、tv（电视剧文件夹）、downloads（下载文件夹） 子目录）
2. 记录目录路径（如 /vol1/1000/docker/MP、/vol1/1000/video），后续配置文件需用到。【可以自定义目录，只要设置对就行】

步骤3：编写 Docker Compose 配置文件

飞牛NAS支持通过 Docker 应用直接导入 Compose 配置，无需手动输入命令：

1. 打开 Docker 应用，点击左侧「项目」，选择「新增」，填写项目名称（如 moviepilot）。
2. 路径选择：点击「浏览」，选中步骤2创建的「docker/MP」目录【选择你设置的目录】。
3. 来源选择「创建 docker compose」，在编辑框中粘贴以下配置（根据实际目录路径修改占位符）：【配置文件下载】 请自行修改里面的一些配置，我的配置文件就飞牛上面使用，群晖的可以上MP官网复制。
4. 修改配置中的关键参数：
   1. vol1下的路径：将 /vol1/1000/mp:/vol1/1000/mp【前面是飞牛里面的绝对目录，后面的是映射进去mp的目录，新人最好不要修改】，将/vol1/1000/mp替换为你的实际存储卷路径。这个目录上面的那两个目录不能修改。
   2. PROXY_HOST=这个后面的是代理地址，你如果安装了代理可以填进去【ip:代理端口】如：192.168.1.133:20171
   3. AUTH_SITE=和 IYUU_SIGN=这两个你如果搞了iyuu就可以填写前面那个就填iyuu，后面就填写你的iyuu密钥【密钥需要去微信里面的爱语飞飞里面获取】

步骤4：启动 MoviePilot 并验证

1. 配置完成后点击「保存」，返回项目列表，找到 moviepilot 项目，点击「启动」。
2. 启动过程中可点击「日志」查看进度，当日志显示「Started successfully」时，说明启动成功。
3. 访问管理界面：打开浏览器，输入 http://你的NAS IP:3000（如 http://10.0.92.3:3000），输入步骤3设置的账号（admin）和密码【密码在日志里面寻找，登录以后记得修改密码】，即可进入 MoviePilot 主界面。

三、群晖NAS安装教程【教程有问题可以反馈】

群晖NAS通过 Container Manager（原 Docker 管理器）安装，需先配置目录权限，再通过 Compose 部署，步骤注重权限适配，避免因权限不足导致启动失败。

步骤1：安装 Container Manager

1. 登录群晖DSM管理界面，进入「套件中心」，搜索「Container Manager」。
2. 点击「安装」，跟随向导完成安装（需同意用户许可协议，无需额外配置）。

【图片6：群晖套件中心搜索 Container Manager 界面；安装向导步骤】

步骤2：创建目录并设置权限

群晖NAS权限管控严格，需提前为 Docker 目录设置读写权限，否则会导致配置文件无法保存：

1. 进入「控制面板」-「共享文件夹」，点击「新增」，创建名为「docker」的共享文件夹（用途：存储所有 Docker 相关配置）。
2. 打开「File Station」，找到刚创建的「docker」文件夹，右键点击「属性」-「权限」-「新增」。
3. 用户与组选择「Everyone」，应用于「全部文件夹、子文件夹及文件」，权限设置为「读取与写入」，点击「应用」并确认「应用到这个文件夹，子文件夹及文件」。
4. 在「docker」文件夹内新建「theater」子文件夹（用于存储 MoviePilot 相关文件）。

【图片7：群晖创建 docker 共享文件夹界面；权限设置界面（标注 Everyone 权限配置）；File Station 新建 theater 目录界面】

步骤3：部署依赖服务（CookieCloud）【MP 站点同步插件配置方法 – 东京热】

MP 需通过 CookieCloud 同步站点 Cookie，建议自建 CookieCloud 服务端（更安全）：

也可以直接搜索easychen/cookiecloud:latest这个拉取镜像

1. 打开 Container Manager，点击左侧「项目」-「新增」，项目名称填写「cookie-cloud」，路径选择「docker/theater」，来源选择「创建 docker compose」。
2. 粘贴以下 Compose 配置： version: "3" services: cookie-cloud: image: easychen/cookiecloud:latest restart: always network_mode: bridge hostname: cookie-cloud ports: - 8088:8088
3. 点击「保存」并启动项目，启动成功后访问 http://你的NAS IP:8088，若出现 CookieCloud 配置界面，说明部署成功。
4. 安装浏览器插件：进入CookieCloud 官方 Release 下载最新插件，解压后在 Chrome 浏览器中打开 chrome://extensions/，开启「开发者模式」，点击「加载已解压的扩展程序」，选择解压目录完成安装。
5. 配置插件：打开 CookieCloud 插件，输入自建服务端地址（http://NAS IP:8088），设置用户KEY和加密密码，点击「保存」并「测试」，确保同步正常。

步骤4：部署 MoviePilot

1. 在 Container Manager 中再次点击「项目」-「新增」，项目名称填写「moviepilot」，路径仍选择「docker/theater」，来源选择「创建 docker compose」。
2. 粘贴以下 Compose 配置（适配群晖权限）： version: "3" services: moviepilot: container_name: moviepilot image: jxxghp/moviepilot:latest volumes: - ./moviepilot/main:/moviepilot # 程序主目录 - ./moviepilot/config:/config # 配置目录 - /volume1/video:/video # 影视资源目录（替换为你的实际目录） environment: - NGINX_PORT=3000 - PUID=0 - PGID=0 - UMASK=022 - SUPERUSER=admin - SUPERUSER_PASSWORD=你的强密码 - API_TOKEN=moviepilot - TZ=Asia/Shanghai - COOKIECLOUD_HOST=http://你的NAS IP:8088 # 关联自建CookieCloud - COOKIECLOUD_KEY=你的插件用户KEY - COOKIECLOUD_PASSWORD=你的插件加密密码 restart: always network_mode: bridge
3. 修改配置：
   1. /volume1/video：替换为你的影视资源目录（如群晖默认的「视频」共享文件夹路径）。
   2. SUPERUSER_PASSWORD：修改为强密码。
   3. COOKIECLOUD_* 相关参数：填写步骤3中设置的用户KEY和加密密码。
4. 点击「保存」并启动项目，通过「日志」查看启动状态，显示「启动成功」后即可访问。
5. 访问管理界面：浏览器输入 http://你的NAS IP:3000，输入账号密码登录。

四、安装后基础配置（通用）

首次登录 MP 后，需完成以下基础配置才能正常使用：

1. 用户认证：点击右上角头像，进入「用户认证」，选择拥有的 PT 站点（如 52PT、馒头）完成认证，解锁全部功能。
2. 添加下载器：进入「设定」-「下载器」，点击「新增」，选择 qBittorrent/Transmission，填写下载器地址（如 http://NAS IP:8080）和端口，用户名和密码，点击「保存」。
3. 配置媒体服务器：进入「设定」-「媒体服务器」，选择已安装的服务（如 Emby），填写服务器地址和 API 密钥，勾选「启用媒体服务器」并保存。
4. 设置存储路径：进入「设定」-「存储&目录」，添加电影、电视剧存储目录，选择整理方式（推荐「硬链接」，不占用额外空间）和覆盖模式，保存配置。

五、常见问题排查

1. 启动失败，日志显示「权限不足」：
   1. 飞牛NAS：检查目录路径是否正确，确保存储卷有读写权限。
   2. 群晖NAS：重新设置 docker 共享文件夹权限，确保 Everyone 有「读取与写入」权限。
2. 无法访问管理界面：
   1. 检查 NAS IP 是否正确，端口是否被占用（可通过 NAS 后台查看端口占用情况）。
   2. 确认 MP 项目已正常启动，重启项目尝试解决。
3. 资源下载失败，提示「无法连接站点」：
   1. 检查 CookieCloud 同步是否正常，重新配置插件并同步 Cookie。
   2. 若网络无法访问外网，可在 MP 高级设置中配置代理服务器。
4. 影视文件无法整理入库：检查存储路径映射是否正确，确保 MoviePilot 有权限访问下载目录和媒体库目录。

六、注意事项

• 管理员密码务必设置为强密码，避免暴露公网，防止站点 Cookie 等敏感数据泄露。
• MP仅用于学习交流，请勿在国内平台公开宣传或用于商业用途。
• 建议定期备份配置文件（MP 配置目录下的 config 文件夹），避免重装丢失数据。

项目官方地址：https://github.com/jxxghp/MoviePilot，获取最新更新及更多功能说明可访问官方仓库。