家用伺服器折腾手记-2:Mac mini 部署 MoviePilot 教程 🎬
前言 📝
在上一篇文章中,我们成功在 Mac mini 上搭建了 Docker 环境。这次我们将继续探索,使用 Docker 部署 MoviePilot,这是一个强大的电影管理工具,可以帮助我们自动下载和管理电影资源。MoviePilot 是 NAStool 的 Python 重制版,提供了更好的性能和更多的功能。
为什么选择 MoviePilot 🤔
相比其他影视管理工具,MoviePilot 具有以下优势:
- 完全开源,持续更新维护
- 支持多种下载器和媒体服务器
- 智能识别电影和剧集信息
- 支持订阅和自动下载
- 界面美观,操作简单
- 支持 Docker 部署,方便管理

环境准备 🛠️
1. 创建工作目录
mkdir -p ~/docker/moviepilot/{config,media}
cd ~/docker/moviepilot
2. 准备 Docker Compose 配置
version: '3'
services:
moviepilot:
image: jxxghp/moviepilot:latest
container_name: moviepilot
hostname: moviepilot
network_mode: bridge
ports:
- "3000:3000"
volumes:
- ./config:/config
- ./media:/media
- /var/run/docker.sock:/var/run/docker.sock
environment:
- PUID=1000
- PGID=1000
- UMASK=022
- TZ=Asia/Shanghai
- MOVIEPILOT_AUTO_UPDATE=true
restart: unless-stopped
部署 MoviePilot 🚀
1. 启动服务
docker-compose up -d
启动后,访问 http://localhost:3000
进入 MoviePilot 的 Web 界面。首次访问需要设置管理员账号和密码。

基础配置 ⚙️
1. 站点配置
MoviePilot 支持多个资源站点,需要配置站点的 Cookie 信息:
# config/sites.yaml
sites:
- name: "站点名称"
url: "站点地址"
cookie: "站点Cookie"
ua: "浏览器 User-Agent"
2. 下载器配置
支持多种下载器,这里以 qBittorrent 为例:
# config/downloaders.yaml
qbittorrent:
host: "http://localhost:8080"
username: "admin"
password: "adminadmin"
category: "电影"

进阶设置 🎯
1. 媒体库整理
配置媒体库路径和命名规则:
# config/media.yaml
library:
movie:
path: "/media/电影"
format: "{title} ({year})/[{resolution}]{title}.{ext}"
tv:
path: "/media/剧集"
format: "{title}/Season {season}/{title} - S{season:02d}E{episode:02d}.{ext}"
2. 订阅规则
设置自动下载的规则:
# config/subscribe.yaml
rules:
- name: "最新电影"
type: "电影"
resolution: ["1080p", "2160p"]
include: ["WEB-DL", "BluRay"]
exclude: ["HC", "CAM"]
size_limit: "40GB"
使用技巧 💡
- 使用豆瓣想看功能自动订阅新电影
- 配置微信通知,及时获知下载进度
- 设置定时刷新,自动检查更新
- 使用过滤规则,避免下载广告资源
常见问题 ❓
1. 无法启动容器
# 检查日志
docker logs moviepilot
# 检查权限
sudo chown -R 1000:1000 ~/docker/moviepilot/config
2. 下载失败
- 检查下载器连接是否正常
- 确认站点 Cookie 是否有效
- 查看是否符合过滤规则
后续计划 📅
在完成 MoviePilot 的部署和配置后,我们还可以进一步优化和扩展系统:
- 集成 Emby 或 Jellyfin 媒体服务器,提供更好的观看体验
- 配置 Nginx 反向代理,实现外网访问
- 添加 Overseerr 用户请求系统
- 设置自动备份和监控
- 优化存储空间管理
- 探索更多自动化工具和插件
在下一篇文章中,我们将介绍如何部署和配置 Emby 媒体服务器,敬请期待!