本教程为 MP 安装完成后的通用配置指南，适配飞牛NAS、群晖NAS等所有支持 Docker 部署的 NAS 环境。配置完成后可实现影视资源的自动搜片、下载、整理、入库全流程自动化，同时优化元数据搜刮效果与系统通知体验。教程按“必备核心配置→进阶优化配置→可选功能配置”逻辑梳理，步骤详细且附带操作指引，新手可按顺序逐步完成。

前置条件：已成功在 NAS 中安装 MP 并能通过浏览器访问管理界面（地址格式：http://你的NAS IP:3000）。

一、必备核心配置（解锁基础功能）

此部分配置为 MP 正常运行的基础，必须完成，否则无法实现核心的搜片、下载与入库功能。

1.1 用户认证（核心前提）

1. 操作步骤：登录 MP 管理界面后，点击右上角头像，在下拉菜单中选择「用户认证」；
2. 选择站点：在支持的 PT 站点列表（如 52PT、馒头、北洋园等）中，勾选自己拥有有效账号的站点；
3. 同步验证：确保已提前通过 CookieCloud 同步该站点的浏览器 Cookie（CookieCloud 部署方法可参考对应 NAS 安装教程），点击「同步 Cookie」按钮，系统将自动获取并验证 Cookie 有效性；
4. 验证结果：若站点状态显示「已认证」，说明认证成功；若认证失败，需重新检查 CookieCloud 同步状态，重新同步后再次尝试。

注意：至少需成功认证 1 个 PT 站点，否则无法解锁自动搜片、资源下载等核心功能。

1.2 下载器配置（资源下载核心）

1. 进入路径：在管理界面左侧导航栏中，依次点击「设定」→「下载器」，然后点击页面中的「新增下载器」按钮；
2. 选择类型：根据你在 NAS 中实际安装的下载器，选择「qBittorrent」（推荐，兼容性更好）或「Transmission」；
3. 1. 1. 若选择 qBittorrent（推荐，兼容性更好）：
   2. 名称：自定义命名（如「qBittorrent-NAS」），便于后续区分管理；
   3. 地址：填写 NAS 的局域网 IP + qBittorrent 的 Web 访问端口（默认端口为 8080，完整格式示例：http://10.0.92.3:8080）；
   4. 用户名/密码：填写 qBittorrent 的登录账号密码（默认账号 admin，默认密码 adminadmin，建议安装后立即修改为强密码）。
   5. 2. 若选择 Transmission（简称 tr）：
   6. 名称：自定义命名（如「Transmission-NAS」），便于后续区分管理；
   7. 地址：填写 NAS 的局域网 IP + Transmission 的 Web 访问端口（默认端口为 9091，完整格式示例：http://10.0.92.3:9091）；
   8. 用户名/密码：填写 Transmission 的登录账号密码（默认无密码，若已设置则填写对应信息；若未设置，建议先进入 Transmission 管理界面「设置」→「远程访问」中配置强密码，提升安全性）；
4. 参数配置（分类型详细说明）：
5. 测试与保存：点击「保存」按钮完成配置，你的qb或者tr如果有流量，上面以后显示出来；若没有，需检查地址、端口、账号密码是否正确，确保对应下载器服务已正常启动（Transmission 需额外确认 9091 端口未被占用且防火墙已放行）；
6. 额外优化（可选）：配置完成后，可在下载器详情页设置「默认保存路径」（建议选择 NAS 中提前创建的 video/downloads 目录【目录根据自己的设置修改】，需与对应下载器自身的默认保存路径一致）、「下载速度限制」「种子保留策略」等参数，适配个人网络环境与存储需求。

1.3 媒体服务器联动（自动入库核心）

通过联动媒体服务器（如飞牛影视, Emby、Jellyfin 等），MP 可将整理后的影视文件自动入库，无需手动添加至媒体库。

1. 进入路径：依次点击「设定」→「媒体服务器」→「新增媒体服务器」；
2. 选择类型：根据你已安装的媒体服务，选择「Emby」「Jellyfin」「Plex」「飞牛影视库」等对应类型；
3. 1. 1. 若选择 Emby：
   2. 名称：自定义命名（如「Emby-家庭影院」）；
   3. 地址：填写 NAS 局域网 IP + Emby 的 Web 访问端口（默认端口 8096，完整格式示例：http://10.0.92.3:8096）；
   4. API 密钥：登录 Emby 管理界面，依次点击「设置」→「高级」→「API 密钥」，点击「新建 API 密钥」，输入名称（如 MP）后点击「创建」，复制生成的 API 密钥粘贴至对应输入框；
   5. 媒体库选择：勾选需要与 MP 联动的媒体库（如「电影库」「电视剧库」）。
   6. 2. 若选择 Jellyfin（开源免费，兼容性广）：
   7. 名称：自定义命名（如「Jellyfin-家庭影院」）；
   8. 地址：填写 NAS 局域网 IP + Jellyfin 的 Web 访问端口（默认端口 8096，完整格式示例：http://10.0.92.3:8096）；若 8096 端口被占用，需填写实际映射的端口（如 8097），访问地址同步调整；
   9. API 密钥：登录 Jellyfin 管理界面，依次点击「控制台」→「API」→「新增 API 密钥」，输入名称（如 MP）后点击「保存」，复制生成的 API 密钥粘贴至对应输入框；
   10. 媒体库选择：勾选需要联动的「电影库」「电视剧库」等，确保媒体库路径与 MoviePilot 存储路径一致。
   11. 3. 若选择 飞牛影视（飞牛NAS专属）：
   12. 名称：自定义命名（如「飞牛影视-本地库」）；
   13. 地址：填写飞牛 NAS 的局域网 IP（格式示例：http://192.168.1.105:5666/v）自行修改中间的ip地址；
   14. 认证配置：飞牛影视无需额外 API 密钥，需确保 MP 与飞牛 NAS 处于同一局域网，且 MP 已获取 NAS 的读写权限；若需验证，可在飞牛 NAS 管理界面「应用中心」→「飞牛影视」→「设置」中，开启「本地服务访问权限」；
   15. 媒体库选择：勾选飞牛影视中已创建的「电影库」「电视剧库」，确保媒体库存储路径与 MP 配置的「电影目录」「电视剧目录」一致。
4. 参数配置（分类型详细说明）：
5. 测试与保存：点击「保存」，过一会有信息就说明同步了。联动生效后，MP 整理后的影视文件将自动同步至对应媒体库并完成元数据匹配（飞牛影视需确保存储路径权限已开放，Jellyfin 若提示端口冲突，可在其容器配置中修改映射端口并同步更新此处地址端口）。

1.4 存储路径与整理规则（文件管理核心）

此配置用于指定影视文件的存储位置与整理格式，确保文件分类清晰，便于媒体服务器识别。

1. 进入路径：依次点击「设定」→「存储&目录」；
2. 基础存储路径配置：
   1. 下载目录：选择 NAS 中提前创建的 video/downloads 目录（需与下载器的默认保存路径一致，根据自己的设置自行修改）；
   2. 电影目录：选择 video/movie 目录（用于存放整理后的电影文件，根据直接的设置自行修改）；
   3. 电视剧目录：选择 video/tv 目录（用于存放整理后的电视剧文件，根据直接的设置自行修改）。
3. 文件整理规则配置（关键优化项）：
   1. 整理方式：优先选择「硬链接」，优点是不占用额外存储空间，仅创建文件链接，删除其中一个文件不影响另一个；若 NAS 存储容量充足，也可选择「复制」；
   2. 【建议默认不动】命名规则：默认规则已包含片名、年份、分辨率等关键信息（如「肖申克的救赎 (1994) 1080p」），可直接使用；也可自定义命名（支持变量：{title} 片名、{year} 年份、{resolution} 分辨率等）；
   3. 覆盖模式：建议不做选择【默认不动】。避免重复覆盖导致数据丢失；若需要更新已有文件，可选择「覆盖同名文件」；
   4. 季集命名【可以默认不动】：电视剧专用，推荐选择「SxxExx」格式（如 S01E01 代表第一季第一集），可完美适配主流媒体服务器的识别规则。
4. 测试验证：配置完成后点击页面中的「测试整理」按钮，选择一个测试文件，系统将模拟整理过程，验证规则是否生效。

二、进阶优化配置（提升使用体验）

完成必备配置后，可通过以下优化配置提升元数据搜刮准确性与系统自动化程度，实现“无人值守”运转。

2.1 TMDB 配置（优化元数据搜刮）【不需要配置，不需要去看】

MP 依赖 TMDB（The Movie Database，电影数据库）获取影视元数据（如海报、剧情简介、演员表、评分等），配置后可大幅提升搜刮准确性。

1. 进入路径：依次点击「设定」→「元数据」→「TMDB 配置」；
2. 获取 TMDB API 密钥：
   1. 访问 TMDB 官方网站（https://www.themoviedb.org/），注册并登录账号；
   2. 登录后点击右上角头像，选择「设置」→「API」→「请求 API 密钥」；
   3. 选择「个人使用」，填写应用名称（如「MP-NAS」），阅读并同意服务条款后提交，即可获得 API 密钥。
3. 配置保存：将获取的 API 密钥粘贴至对应输入框，语言选择「中文」，地区选择「中国大陆」，点击「保存」即可生效。

2.2 自动化规则配置（实现无人值守）【配合订阅使用】

开启自动化规则后，系统可自动完成搜片、下载、整理、入库全流程，无需手动干预。

1. 进入路径：依次点击「设定」→「自动化」；
2. 核心规则开启与配置：
   1. 自动搜片：开启后设置「每日自动搜片时间」（如 23:00）和「搜片频率」（如每日 1 次），系统将自动根据你添加的「想看清单」搜索资源；
   2. 自动下载：开启后，系统会自动将搜索到的符合条件（可自定义分辨率、文件大小、种子数等筛选条件）的资源提交至下载器下载；
   3. 自动整理：开启后，下载完成的影视文件将自动按照「存储&目录」中的规则完成整理，并同步入库至媒体服务器；
   4. 自动清理：开启后可设置「清理下载目录过期文件」（如清理 7 天前已完成下载的文件）、「清理大于 X 天的种子」（如清理 30 天前的种子），自动释放 NAS 存储空间。
3. 保存生效：根据个人需求开启对应规则并设置具体参数，点击「保存」后，自动化规则即可生效。

三.没有代理的情况

1.设定~系统~高级设置~媒体~tmdb api服务地址，选择下面那个api，大部分地区可以连通tmdb订阅视频

2.有可以安装一个插件来实现代理的效果【我没有使用过所以不太了解，如果你知道可以在下面留言】

2.有搭建代理的可以去:设定~系统~高级设置~媒体~网络~代理服务器，这里填写你的代理ip。【如http://192.168.1.105:20171】根据自己的自行修改。

四、可选功能配置（按需开启）

此类配置非必需，可根据个人需求选择开启，提升系统使用的便捷性。

3.1 通知配置（及时掌握系统状态）【vocechat通知配置】

通过配置通知功能，可实时接收系统运行状态提醒（如下载完成、搜片成功、配置错误等）。

1. 进入路径：依次点击「设定」→「通知」；
2. 推荐配置（微信通知，操作简单）：
   1. 勾选「开启微信通知」，页面将显示一个二维码；
   2. 使用微信扫描二维码，关注官方公众号并完成绑定；
   3. 勾选需要接收通知的事件（如下载完成、搜片成功、配置错误、自动化任务执行失败等）。
3. 保存生效：配置完成后点击「保存」，当系统触发对应事件时，你将收到微信通知，实时掌握系统运行状态。

五、配置完成验证

完成以上配置后，可通过以下步骤验证系统是否正常运行：

1. 在 MP 主界面点击「想看」，添加一部影视资源至「想看清单」；
2. 手动触发一次「自动搜片」（「设定」→「自动化」→「立即执行搜片」）；
3. 查看搜片结果，若搜索到符合条件的资源并自动提交至下载器，说明配置正常；
4. 等待下载完成，检查文件是否自动整理至对应目录，并成功入库至媒体服务器。

六、常见配置问题排查

1. 用户认证失败：检查 CookieCloud 是否正常同步，确认 PT 站点账号未过期，重新同步 Cookie 后再次尝试；
2. 下载器连接失败：检查下载器服务是否正常启动，地址、端口、账号密码是否正确，确保 MoviePilot 与下载器在同一局域网且网络通畅；
3. 文件无法自动整理入库：检查存储路径映射是否正确，确保 MoviePilot 对下载目录和媒体目录有读写权限，整理规则中的目录路径与实际 NAS 目录一致；
4. 元数据搜刮失败：检查 TMDB API 密钥是否有效，网络是否能正常访问 TMDB 官网，可尝试更换网络或重新获取 API 密钥。

【图片说明：用户认证及 Cookie 同步界面；qBittorrent API 密钥获取界面；Emby/Jellyfin/飞牛影视 API 密钥/权限配置界面；存储路径与整理规则配置界面；TMDB API 密钥获取界面；自动化规则配置界面；微信通知绑定界面】

项目官方配置文档参考：https://github.com/jxxghp/MoviePilot/wiki/%E9%85%8D%E7%BD%AE%E6%96%87%E6%A1%A3