升级与备份
面板内升级
「系统 → 系统升级」页面可检查新版本并查看更新说明。
更新检测支持双通道：
| 通道 | 说明 |
|---|---|
| 稳定版 | 只检测正式发布版本 |
| 开发版 | 包含预发布版本（prerelease），可提前体验 |
- 通道选择持久化保存，未设置时回退环境变量
GOPANEL_UPGRADE_CHANNEL - 比较规则为语义化版本：
1.3.0-beta.1 < 1.3.0-beta.2 < 1.3.0 - 当前版本高于所选通道最新版时（如开发版切回稳定通道）会明确提示不自动降级
相关环境变量（GOPANEL_UPGRADE_*）见 环境变量。
容器升级
bash
docker pull docker.cnb.cool/liumou_site/gopanel/backend:latest
docker rm -f gopanel
# 用原命令重新 docker run（挂载目录不变即可保留数据与配置）SQLite 用户务必挂载了 /app/config。
二进制升级
bash
# 重新执行安装脚本（会替换二进制并重启服务）
curl -fsSL https://cnb.cool/liumou_site/GoPanel/-/raw/master/scripts/install.sh | bash -s -- -install或手动：停服务 → 替换二进制 → 启服务。配置文件与 config/ 数据目录保持不变。
备份什么
| 内容 | 位置 |
|---|---|
| 数据库 | MySQL / MariaDB / PostgreSQL 用数据库自身工具；SQLite 直接备份 config/*.db |
| 配置文件 | config/config.toml |
| 主密钥 | data/master.key（或 GOPANEL_BASTION_KEY 的值）——必须备份，丢了旧密文与安全码要重置 |
| 证书私钥 | data/ssl/keys/ |
| 日志 | data/logs/（可选） |
⚠️ 主密钥与数据库要配套备份：只恢复数据库而密钥不同，堡垒机凭据与安全码会全部失效。