如何10分钟快速部署Pluton:Docker Compose搭建自托管备份平台教程

原创2026-10-24 20:30:511,912 阅读

如何10分钟快速部署Pluton:Docker Compose搭建自托管备份平台教程

Pluton 是一款开源的自托管备份平台,基于 Restic 实现加密增量备份、Rclone 连接 70+ 云存储,提供可视化的 Web 管理界面。本文将带你用 Docker Compose 在 10 分钟内完成 Pluton 部署,从零搭建属于自己的加密备份服务,无需任何编程基础。

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

核心部署文件说明:

四、创建 .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

⚠️ 注意两点:

  1. 源文件挂载加 :ro(只读),防止备份进程误写原始文件;
  2. 备份目标目录不加 :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 守护 🚀

登录后查看全文
pluton