一、MoviePilot 简介（为什么需要它？）

MoviePilot（MP）是一个强大的媒体自动化管理工具。它的核心价值在于将影视资源的搜索、下载、媒体库整理和追剧过程完全自动化。

• 核心功能： 自动化检索、智能筛选、下载管理、文件整理（重命名、分类到媒体库）、订阅追剧。

• 定位： 它是连接“资源站”和“媒体服务器”（如 Jellyfin、Plex、Emby）的自动化“中枢”。

二、环境准备：选择你的平台

MoviePilot 推荐使用 Docker 部署，因为它最稳定且易于管理。

【建议】： 除非您的受众都是 Windows 或群晖用户，否则请以 Docker Compose 方式作为主教程。

三、核心安装步骤（以 Docker Compose 为例）

这是最快、最标准的安装方式。

步骤 1: 准备 docker-compose.yml 文件

在您的服务器或 NAS 上创建一个文件夹，例如 /opt/moviepilot，并在其中创建 docker-compose.yml 文件。

YAML

version: "3.8"
services:
  moviepilot:
    image: jxxghp/moviepilot:latest
    container_name: moviepilot
    # 保持网络模式为 bridge 或 host，取决于您的配置，host 模式配置更简单
    network_mode: "host" 
    ports:
      - "8002:8002" # Web UI 端口
    environment:
      - PUID=1000 # 您的用户ID，使用 id -u 命令查看
      - PGID=1000 # 您的用户组ID，使用 id -g 命令查看
      - TZ=Asia/Shanghai # 时区设置
    volumes:
      # 核心配置目录，请确保映射
      - /opt/moviepilot/config:/config 
      # 【重要】下载目录，必须映射
      - /path/to/your/downloads:/downloads 
      # 【重要】媒体库目录，必须映射
      - /path/to/your/media:/media 
    restart: unless-stopped

关键点： 请务必将 /path/to/your/downloads 和 /path/to/your/media 替换为您的实际路径，并确保 MoviePilot 容器、下载器（如 qBittorrent）和您的媒体服务器（如 Jellyfin）都能访问这些目录。

步骤 2: 启动容器

在 docker-compose.yml 所在的目录下，执行启动命令：

Bash

docker compose up -d

步骤 3: 访问 Web 界面

容器启动后，通过浏览器访问 http://您的IP地址:8002。

四、系统核心配置（实现自动化）

初次登录后（默认密码通常是 moviepilot 或在登录页面有提示），请立即修改密码并进行以下核心配置。

1. 目录配置：统一路径管理

• 路径一致性是自动化成功的关键！ 确保 MoviePilot、下载器和媒体服务器看到的路径是一致的。

• 在 MP 的【设置 - 目录】中，设置：

  • 资源目录 (Downloads): 对应您 docker-compose.yml 中的 /downloads 容器路径。

  • 媒体库目录 (Media): 对应您 docker-compose.yml 中的 /media 容器路径。

• 启用文件整理： 确保开启文件整理功能，MP 会自动将下载完成的资源移动、重命名并归类到您的媒体库目录。

2. 下载器配置：获取资源

• 在 MP 的【设置 - 下载器】中，添加您的下载客户端（推荐 qBittorrent）。

• 关键配置：

  • 输入下载器的 IP 地址和端口。

  • 输入下载器的用户名和密码。

  • 重点： 勾选 “自动分类管理”，并将远程路径（下载器看到的路径）设置为 MP 容器中下载目录的路径（即 /downloads）。

3. 媒体服务器配置（可选但推荐）

• 在 MP 的【设置 - 媒体库】中，配置 Jellyfin/Plex/Emby。

• 配置目的是：

  1. 当 MP 完成文件整理后，自动通知媒体服务器刷新内容。

  2. MP 可以获取媒体服务器的观看记录和状态，进行更智能的管理。

五、开始自动化追剧（订阅）

完成核心配置后，您就可以开始使用自动化功能了。

1. 站点管理： 在【设置 - 站点】中，配置您的 PT/BT 站点的 Cookie 或 API Key。

2. 搜索： 在【搜索】页面输入您想看的影视名称，MP 会自动从配置的站点中搜索资源。

3. 订阅追剧：

   • 在搜索结果中找到您想追的剧集。

   • 点击 “订阅”，设置您的期望画质（如 1080P 或 4K）。

   • MP 会自动监控站点的最新剧集，一旦有符合您要求的资源发布，它将自动触发下载，并在下载完成后自动整理到您的媒体库。

💡 小结与重要提醒

• 路径是关键： 大多数问题都出在 MoviePilot、下载器和媒体库之间的路径不一致。请反复检查它们在容器内外的映射关系。

• 日志排错： 如果遇到问题，请第一时间查看 MoviePilot 的运行日志，通常会有清晰的错误提示。

• 最新信息： 由于软件更新迭代快，所有具体的 API 或参数配置请务必以官方 Wiki (即您提供的 GitHub 仓库) 的最新内容为准。