MoviePilot (jxxghp/MoviePilot)
Searching Database…
11.9K ·GitHub
这是什么?
MoviePilot 是一款自托管的自动化工具,用于管理 NAS 上的影音库。它覆盖电影和剧集的完整流程:订阅、搜索、下载、整理、刮削元数据、刷新媒体服务器,并发送通知。
这是桌面软件,还是我要在 NAS 上运行的网页服务?
这是一个自托管的网页应用,采用前后端分离架构:后端基于 FastAPI,前端基于 Vue 3。它需要长期在 NAS 或服务器上运行,而不是本地桌面程序。
我该怎么安装和运行 MoviePilot?
推荐使用 Docker 部署:V3 使用独立的镜像 jxxghp/moviepilot-v3(旧版 V2 仍沿用原镜像名称),Compose 示例和环境变量说明见官方 Wiki。也可以从源码安装,然后用本地的 `moviepilot` 命令行工具管理(init、start、stop、update、config)。
我需要先装好下载器或媒体服务器吗?
需要。MoviePilot 是一个中枢,负责连接外部的下载器、媒体服务器、元数据源和通知渠道,还可以接入可选的插件、工作流和 AI 智能体。你需要先配置好这些服务,它才能真正对你的影音库进行操作。
使用上有哪些限制需要注意?
本项目明确仅供学习研究使用,禁止商业用途和违法用途;作者也希望不要在国内中文平台上推广。此外,若重新分发修改版本,不建议绕过或修改内置的身份验证系统,由这样做的人自行承担相应责任。
内置的 Agent/AI 功能是做什么的?
配置好模型后,可以用自然语言驱动 MoviePilot 内置的 AI 智能体,完成搜索、订阅、下载、整理影音库以及排查问题等操作。其他智能体可以导入 skills/ 目录,外部 MCP 客户端也可以通过 /api/v1/mcp 接口连接。
插件和相关工具放在哪里?
插件单独放在 MoviePilot-Plugins 仓库中。配套项目还包括前端 MoviePilot-Frontend、共享资源 MoviePilot-Resources、服务端版本 MoviePilot-Server,以及 Rust 重写版 MoviePilot-Rust。
我能用 PostgreSQL 替代默认数据库吗?
可以,PostgreSQL 是受支持的后端,具体设置步骤单独记录在 docs/postgresql-setup.md 中。
What are similar projects?
evenfire, gpt4free, Douyin_TikTok_Download_API, TradingAgents-CN, XHS-Downloader, open-swe, nocobase, knoweldge-base
Which topics is it in?
media-server, fastapi, workflow, model-context-protocol, vue, command-line, rest-api, plugin, gplv3, web-app, agent, mcp