项目介绍
MoviePilot v2 用于媒体检索、订阅、下载和整理。下文介绍 V2 Compose、目录准备和部署后的连接检查。容器内的媒体、下载目录应与下载器保持一致,先完成下载器连接和小规模整理测试。
moviepilot-v2
version: '3.3'
services:
moviepilot:
stdin_open: true
tty: true
container_name: moviepilot-v2
hostname: moviepilot-v2
network_mode: host
# networks:
# - moviepilot
# ports:
# - '3000:3000'
# - '3001:3001'
volumes:
- '/media:/media'
- '/moviepilot-v2/config:/config'
- '/moviepilot-v2/core:/moviepilot/.cache/ms-playwright'
- '/var/run/docker.sock:/var/run/docker.sock:ro'
environment:
- 'NGINX_PORT=3000'
- 'PORT=3001'
- 'PUID=0'
- 'PGID=0'
- 'UMASK=000'
- 'TZ=Asia/Shanghai'
# - 'AUTH_SITE=iyuu' # v2.0.7+版本以后,可不设置,直接通过 UI 配置
# - 'IYUU_SIGN=xxxx'
- 'SUPERUSER=admin' # 设置超级用户
# - 'API_TOKEN=无需手动配置,系统会自动生成。如果需要自定义配置,必须为16位以上的复杂字符串'
restart: always
image: jxxghp/moviepilot-v2:latest
# networks:
# moviepilot:
# name: moviepilotmp刷流插件的简单设置教程
一、什么是 mp 刷流插件?
mp 刷流插件通常指 Moviepilot-V2的插件市场里面的“站点刷流”插件,它能帮助用户自动完成模拟做种行为,维持上传量,实现自动刷流。
⚠️ 注意:使用刷流工具需遵守各PT站点规则,避免频繁请求导致封号!

二、 版本的选择
频率设置建议(防封策略)
类型 | 建议间隔 | 说明 |
🔹 低频版 | 15~30分钟 | 安全稳定,适合大多数站点 |
🟡 普通版 | 10分钟 | 多数站点允许,但不建议同时多站高频 |
❗ 强烈建议:不同站点错开请求时间,避免集中访问。
三、 配置
基本配置

选种规则
做种人数:0-1

删种规则

补充:部署与使用
配置与操作示例
V2 基础 Compose
此配置针对 V2,V3 使用不同镜像与初始化流程,不在已有数据库上直接跨主版本尝试。下方准备命令创建所需目录并自动生成 MP_PASSWORD,PUID、PGID 已写为 0:
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/moviepilot-v2/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/moviepilot-v2 /volume1/docker/moviepilot-v2/config /volume1/docker/moviepilot-v2/core /volume1/media-test
cd /volume1/docker/moviepilot-v2
umask 077
touch .env
if ! grep -q "^MP_PASSWORD=." .env; then
generated_secret=$(openssl rand -hex 32)
printf 'MP_PASSWORD=%s\n' "$generated_secret" >> .env
fi
chmod 600 .env
HALO_PREPARE
cd /volume1/docker/moviepilot-v2
所需密码和密钥已自动生成到项目目录的 .env,已有非空值会保留。查看初始化密码可在自己的终端执行 sudo cat /volume1/docker/moviepilot-v2/.env;该文件只保留在本机。
本示例使用数值 0 访问挂载目录,无需查询或填写 UID/GID。
services:
moviepilot:
image: jxxghp/moviepilot-v2:latest
hostname: moviepilot-v2
environment:
NGINX_PORT: "3000"
PORT: "3001"
PUID: "0"
PGID: "0"
UMASK: "022"
TZ: Asia/Shanghai
SUPERUSER: admin
SUPERUSER_PASSWORD: "${MP_PASSWORD}"
ports:
- "3000:3000"
- "3001:3001"
volumes:
- /volume1/media-test:/media
- /volume1/docker/moviepilot-v2/config:/config
- /volume1/docker/moviepilot-v2/core:/moviepilot/.cloakbrowser
restart: unless-stopped
当前官方 V2 文档的浏览器持久化位置为 /moviepilot/.cloakbrowser,不同历史发行可能不同。3000 为网页、3001 为 API;只在所需网络中开放。Docker socket 仅在确有需要的容器管理功能中另行添加。
访问 http://NAS_IP:3000,用 .env 中设置的初始密码登录,再配置下载器和媒体服务。要硬链接整理时,下载与媒体目录放在同一支持硬链接的文件系统,并以同一个父目录挂载;两个独立绑定挂载不能仅凭「同一个卷」就保证可硬链接。
先搜索一项有权使用的测试内容,发送到下载器,确认保存路径,再测试识别与整理。订阅、自定义优先级、通知和插件在此基础上逐一启用。升级到 V3 前备份数据库;V3 写入新结构后不能简单换回 V2 标签恢复。
启动与状态检查
在保存 compose.yaml 和所需 .env 的项目目录执行:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
config 用于检查配置,不会启动服务。示例使用上游浮动发行通道;长期运行可改为项目实际发布的固定标签或已记录的镜像摘要,不猜写版本号。日志中出现的初始密码和访问凭据仅在自己的终端查看。
常见问题
- 下载成功但整理找不到文件:通常要检查两端挂载和路径映射,而不是重新下载。
- 权限不足时调整所需目录与用户,不把全部存储目录改成任何人可写。
更新与备份
备份应用配置、数据库、规则与下载器设置,保存实际镜像版本和媒体路径表。
更新前记录当前镜像或仓库提交,停止会写入的任务并备份持久化数据;阅读版本迁移说明后再拉取并重建。数据库已经迁移时,回退还需要匹配的数据副本。需要暂时停服务可用 docker compose stop,不要把删除卷或清空数据目录当作更新步骤。