跳到主要内容

更新

常规更新​

默认所有组件都使用 latest 标签，因此更新只需两条命令：

docker compose pull
docker compose up -d

如果需要固定某个版本，请在 .env 中指定 —— 所有组件共用一个变量：

# .env
XLADA_VERSION=1.1.7

数据库迁移会在面板容器启动时自动应用。

更新之前​

导出数据库转储 —— 这是唯一可靠的恢复手段：

docker exec xpanel-db pg_dump -U xpanel xpanel > backup-$(date +%F).sql

也请保存 .env：APP_SECRET、POSTGRES_PASSWORD 和域名必须在更新后 保持不变。

不能做的事​

  • docker compose down -v —— -v 会连数据卷一起删除，包括数据库。
  • 首次启动后修改 APP_SECRET —— 登录和 TOTP 会失效。
  • 修改数据卷和服务名 —— 更新时 compose 会创建新的空数据卷， 而数据仍留在旧数据卷中。

回滚​

docker compose down
# 把 .env 中的 XLADA_VERSION 改回之前的值
docker compose up -d
docker exec -i xpanel-db psql -U xpanel -d xpanel < backup-2026-01-01.sql
注意

迁移不会自动回滚。如果新版本已经应用了迁移，恢复数据转储是让 schema 回到 原状态的唯一办法。

查看当前版本​

版本显示在面板页脚和 API 响应中：

curl -s https://panel.example.com/api/system/health | head