前言
如果你正在用飞牛 OS（fnOS）搭建家庭影音中心，大概率会接触到 MoviePilot 这款自动化媒体管理神器。但很多新手在安装时会遇到两个拦路虎：一是部署配置踩坑不断，二是没有 PT 站账号导致功能受限。
本指南将一次性解决这两个问题，从 Docker 部署到无 PT 账号的替代方案，全程保姆级教学。
一、MoviePilot 是什么？
MoviePilot 是一款专为家庭影音爱好者打造的自动化媒体管理系统，由原 Nastool 作者开发，是 Nastool 的上位替代版本。完全开源免费，支持 Docker 部署。
核心能力：
二、飞牛 OS 部署 MoviePilot
2.1 为什么选飞牛 OS？
飞牛 fnOS 是基于 Debian 12 的国产 NAS 系统，预装 Docker，提供图形化 Docker Compose 管理界面，部署 MoviePilot 非常方便。系统免费正版，无需破解；预装 Docker 和 docker-compose，开箱即用；图形化 Compose 管理，新手友好；自带 FN Connect 免费内网穿透。
2.2 硬件要求
CPU 最低 2 核（推荐 4 核+），内存最低 2GB（推荐 4GB+），系统盘 16GB（推荐 32GB SSD），网络需能访问互联网（推荐千兆有线）。
2.3 了解飞牛 OS 文件路径
飞牛 OS 使用 /vol1、/vol2 等作为存储空间挂载点，admin 用户的"我的文件"通常对应 /vol1/1000/。查看绝对路径：在文件管理器中右键文件夹 → 属性/详情。
2.4 规划目录结构
特别注意：下载目录和媒体库目录必须在同一个根目录下，否则无法使用硬链接功能。建议在 /vol1/1000/ 下创建 docker/moviepilot/config 和 core 子目录，以及 影视/下载 和 影视/媒体库 子目录。
⚠️ 硬链接的重要前提：下载目录和媒体库目录必须在同一个根目录映射下，容器内统一映射为 /media。如果分开映射或跨存储池，硬链接会失败，只能用复制模式（占用双倍空间）。
2.5 创建目录
在文件管理器中创建上述目录结构：新建 docker/moviepilot/config 和 core 子目录，新建 影视/下载 和 影视/媒体库 子目录。
三、Docker Compose 部署
3.1 创建 Compose 项目
打开飞牛 OS 桌面的「Docker」应用，左侧菜单点击「Compose」→「新增项目」，项目名称填 moviepilot，路径选择 /vol1/1000/docker/moviepilot，点击「创建 docker-compose.yml」。
3.2 docker-compose.yml 配置模板
将以下配置复制粘贴，修改路径和认证信息后使用。关键配置项：容器名 moviepilot-v2，端口 3000（WEB）和 3001（API），卷挂载 /vol1/1000/影视:/media、config:/config、core:/moviepilot/.cache/ms-playwright、docker.sock:/var/run/docker.sock:ro，环境变量包括 NGINX_PORT=3000（不可改）、PUID=0、PGID=0、TZ=Asia/Shanghai、SUPERUSER=admin、AUTH_SITE=iyuu、IYUU_SIGN=你的令牌。镜像：jxxghp/moviepilot-v2:latest。
⚠️ 注意事项：NGINX_PORT 不要修改，修改后容器会不断重启；PUID=0 和 PGID=0 推荐使用 root 权限；认证站点配置是必填项，不配置将无法使用搜索、订阅等核心功能。
3.3 启动与登录
确认配置后点击「确定」启动。首次启动需要拉取镜像并编译前端代码，预计 15-20 分钟。启动完成后访问 http://飞牛NAS_IP:3000。
3.4 获取初始密码
如果配置了 SUPERUSER_PASSWORD，直接用设置的密码。否则在容器日志中搜索 password 或在 config/logs/moviepilot.log 中查找随机生成的密码。
3.5 初始配置
① 站点认证：点击右上角头像 →「用户认证」
② 目录配置：设定→系统→目录设置，下载目录 /media/下载，整理后目录 /media/媒体库，整理方式硬链接（推荐），监控模式性能模式
③ 下载器配置：设定→系统→下载器，填写 qBittorrent 或 Transmission 的地址和账号
④ 媒体服务器：设定→系统→媒体服务器，配置 Emby/Jellyfin/Plex 联动
