MoviePilot

简体中文 | English

基于 NAStool 部分代码重新设计，聚焦自动化核心需求，减少问题同时更易于扩展和维护。

仅用于学习交流使用，请勿在任何国内平台宣传该项目！

发布频道：https://t.me/moviepilot_channel

主要特性

• 前后端分离，基于FastApi + Vue3。
• 聚焦核心需求，简化功能和设置，部分设置项可直接使用默认值。
• 重新设计了用户界面，更加美观易用。

安装使用

官方Wiki：https://wiki.movie-pilot.org

Go Worker 加速（默认启用）

为提升搜索、文件监控、文件转移等高频任务的性能，本项目内置了若干 Go 编写的 Worker 子进程（mp-watcher / mp-transfer / mp-indexer），通过 Unix Domain Socket 与 Python 主进程通信，能显著降低 GIL 竞争并提升并发度。

容器默认行为（v2 起）：

• WORKER_MODE 默认值为 hybrid
• WORKER_ENABLED 默认启用 watcher,transfer,indexer 三个 Worker

容器启动时会自动拉起对应的 Go 进程；若二进制不存在或运行异常，Python 端会自动 fallback 到原有路径，对业务完全透明，老用户升级零感知。

如何切回纯 Python 模式

如需禁用所有 Go Worker、强制走原 Python 实现，只需将 WORKER_MODE 显式设为 python：

方式一：docker run 命令行

docker run -d \
  -e WORKER_MODE=python \
  ...其它参数... \
  jxxghp/moviepilot-v2:latest

方式二：docker-compose.yml

services:
  moviepilot:
    image: jxxghp/moviepilot-v2:latest
    environment:
      - WORKER_MODE=python

方式三：${CONFIG_DIR}/app.env 配置文件

WORKER_MODE='python'

按需启用部分 Worker

若仅希望启用其中部分 Worker，保持 hybrid 模式并通过 WORKER_ENABLED 指定即可：

# 仅启用搜索加速
-e WORKER_MODE=hybrid -e WORKER_ENABLED=indexer

# 启用搜索 + 文件监控
-e WORKER_MODE=hybrid -e WORKER_ENABLED=indexer,watcher

详细的 Worker 架构与开发文档见 workers/README.md。

本地 CLI

一键安装运行脚本：

curl -fsSL https://raw.githubusercontent.com/landuo/MoviePilot/v2/scripts/bootstrap-local.sh | bash

使用 moviepilot 命令管理MoviePilot，完整 CLI 文档：docs/cli.md

为 AI Agent 添加 Skills

npx skills add https://github.com/jxxghp/MoviePilot

参与开发

API文档：https://api.movie-pilot.org

MCP工具API文档：详见 docs/mcp-api.md

开发环境准备与本地源码运行说明：docs/development-setup.md

插件开发说明：https://wiki.movie-pilot.org/zh/plugindev

相关项目

• MoviePilot-Frontend
• MoviePilot-Resources
• MoviePilot-Plugins
• MoviePilot-Server
• MoviePilot-Wiki

免责申明

• 本软件仅供学习交流使用，任何人不得将本软件用于商业用途，任何人不得将本软件用于违法犯罪活动，软件对用户行为不知情，一切责任由使用者承担。
• 本软件代码开源，基于开源代码进行修改，人为去除相关限制导致软件被分发、传播并造成责任事件的，需由代码修改发布者承担全部责任，不建议对用户认证机制进行规避或修改并公开发布。
• 本项目不接受捐赠，没有在任何地方发布捐赠信息页面，软件本身不收费也不提供任何收费相关服务，请仔细辨别避免误导。

贡献者