如何10分钟快速部署Pluton:Docker Compose搭建自托管备份平台教程
如何10分钟快速部署Pluton:Docker Compose搭建自托管备份平台教程
Pluton 是一款开源的自托管备份平台,基于 Restic 实现加密增量备份、Rclone 连接 70+ 云存储,提供可视化的 Web 管理界面。本文将带你用 Docker Compose 在 10 分钟内完成 Pluton 部署,从零搭建属于自己的加密备份服务,无需任何编程基础。
一、认识Pluton:为什么选择自托管备份?
🔐 Pluton 把两大开源工具(Restic 负责加密备份、Rclone 负责云存储连接)封装进一个简洁的 Web 界面,核心能力包括:
- 端到端加密:备份数据从本地到云端全程加密,密钥只在你手中;
- 3-2-1 备份复制:自动把备份同步到多个存储,构建安全的备份策略;
- 灵活的定时任务:支持精细的保留策略(retention policies)与自动重试;
- 事件通知:备份结果可通过 Email、Slack、Discord、NTFY 推送;
- 实时进度追踪:备份进度、日志全部在界面内查看。
一句话:它是"自己家里的备份中心",数据完全由你掌控。
二、部署前准备:环境检查清单
开始前,请确认你的服务器(Linux / macOS / Windows WSL2 均可)满足以下条件:
| 检查项 | 要求 | 验证命令 |
|---|---|---|
| Docker Engine | 已安装 | docker --version |
| Docker Compose | v2 版本 | docker compose version |
| 内存 | ≥ 1 GB | free -h |
| 端口 | 默认 5173 未被占用 | ss -tlnp | grep 5173 |
✅ 只要 Docker 和 Docker Compose 能正常输出版本号,就可以继续下一步。
三、获取部署文件
Pluton 仓库中已内置一份可直接使用的 docker-compose.yml 和 Dockerfile,克隆仓库即可拿到全套部署文件:
git clone https://gitcode.com/gh_mirrors/plut/pluton
cd pluton
核心部署文件说明:
- docker-compose.yml —— 一键部署编排文件,容器名固定为
pluton-backup; - Dockerfile —— 镜像构建脚本(拉取官方镜像时不需要它);
- pluton.env.template —— 环境变量模板参考。
四、创建 .env 配置文件:3 个必填变量
🐳 项目的 compose 文件通过 .env 读取配置。在 pluton 目录下新建 .env,只有 3 个变量是必填的:
# ===== 必填:安全与认证 =====
# 备份加密密钥,至少12位,务必妥善保管(丢了就无法解密备份!)
ENCRYPTION_KEY=s0eK1r12973fS501SW
USER_NAME=admin
USER_PASSWORD=your-secure-password
# ===== 可选:覆盖默认值 =====
APP_TITLE=Pluton
APP_URL=http://localhost:5173
SERVER_PORT=5173
MAX_CONCURRENT_BACKUPS=2
SESSION_DURATION=7
💡 生成高强度加密密钥的小技巧:
openssl rand -base64 24
各变量含义速查:
| 变量 | 作用 | 默认值 |
|---|---|---|
ENCRYPTION_KEY |
Restic/Rclone 快照加密密钥 | 无(必填) |
USER_NAME / USER_PASSWORD |
Web 界面管理员账号 | 无(必填) |
SERVER_PORT |
对外访问端口 | 5173 |
APP_URL |
对外访问地址(用于通知链接等) | http://localhost:5173 |
MAX_CONCURRENT_BACKUPS |
并发备份任务数 | 2 |
SESSION_DURATION |
登录会话保持天数 | 7 |
TRUST_PROXY |
反向代理(Nginx/Caddy)后设为 1 |
注释状态 |
五、挂载目录:让容器访问你的文件
默认情况下,compose 只挂了一个数据卷 pluton-data:/data(存放数据库、配置和日志)。要真正开始备份,还需要把要备份的目录映射进容器,在 docker-compose.yml 的 volumes 中按需取消注释:
volumes:
- pluton-data:/data
# 要备份的源文件(只读,以 :ro 结尾)
- /home/user/documents:/mnt/documents:ro
# 备份存放位置(本地存储,必须可写,不能加 :ro)
- /mnt/disk1/backups:/mnt/backups
⚠️ 注意两点:
- 源文件挂载加
:ro(只读),防止备份进程误写原始文件; - 备份目标目录不加
:ro,因为要可写;在 Pluton 界面里选择容器内路径(如/mnt/backups),而不是宿主机路径。
六、一键启动并验证部署
一切就绪,只需一条命令:
docker compose up -d
然后按顺序验证 🧪:
1. 查看启动日志,确认服务正常起来:
docker compose logs -f pluton-backup
2. 访问健康检查接口,返回 {"status":"healthy"} 即为成功(对应 health.ts 中的 /api/health 端点):
curl http://localhost:5173/api/health
3. 浏览器打开 http://localhost:5173,用 .env 中的 USER_NAME / USER_PASSWORD 登录,即可看到备份计划管理界面。
七、常用运维命令速查
| 场景 | 命令 |
|---|---|
| 启动 / 停止 | docker compose up -d / docker compose down |
| 实时查看日志 | docker compose logs -f pluton-backup |
| 重启容器 | docker compose restart pluton-backup |
| 升级到最新版本 | docker compose pull && docker compose up -d |
| 备份应用数据 | 导出 pluton-data 卷(含数据库与配置) |
📌 所有数据(数据库、配置、日志)都保存在 pluton-data 命名卷中,升级镜像不会丢失配置。
八、常见问题快速排查
- 端口被占用:改
.env里的SERVER_PORT(如7173),再docker compose up -d即可。 - ENCRYPTION_KEY 忘了怎么办:密钥丢失意味着已加密备份无法解密,请把它存入密码管理器,切勿更换。
- 放在 Nginx / Caddy 反代之后:取消 docker-compose.yml 中
TRUST_PROXY: 1的注释。 - 容器反复重启:先跑
docker compose logs -f pluton-backup看报错,最常见原因是.env缺少必填变量。 - 健康检查返回 503:说明数据库尚未就绪,等待
start_period(40 秒)后重试。
总结
回顾一下这 10 分钟你完成了什么:克隆仓库 → 配置 .env(3 个必填变量)→ 挂载目录 → docker compose up -d → 登录使用。现在你已拥有一个加密、自动化、可接入 70+ 存储的自托管备份平台,下一步就可以创建第一个 Backup Plan,把重要文件交给 Pluton 守护 🚀
