备份与迁移
GoPanel 的备份分为两层:面板全量数据(一键 ZIP 导出 / 导入)与 数据库实例备份(在数据库管理中按实例执行)。
面板全量备份(ZIP)
面板提供全量数据导出入口,一键把运行期数据打包下载:
- 打包内容(相对面板工作目录):
data/—— 整个运行期数据目录(SQLite 库、SSL 证书与私钥、上传文件、日志等)config/config.toml—— 面板配置文件(不存在则跳过)
- 导入恢复:上传 ZIP 后解压覆盖到工作目录,重启面板后生效
- 导入时逐条做路径越界校验(zip slip 防护),导出 / 导入包均限制 1GB 上限
- 典型场景:跨机迁移(旧机导出 → 新机导入)、重装系统前的快速留档
MySQL / PostgreSQL 等外部数据库不在该 ZIP 内(面板库仅为 SQLite 时才是全量), 请配合下方的实例备份单独导出。
数据库实例备份
在 数据库管理 中按实例一键备份 / 恢复:
- MySQL(mysqldump)、PostgreSQL(pg_dump)、MongoDB(mongodump 归档)、 Redis(SAVE + RDB),备份文件自动 gzip 压缩
- 本机容器实例在容器内执行备份工具,宿主机无需安装客户端
升级相关
- 升级面板本身见 升级与备份(升级包重启后自动替换,旧程序保留为
GoPanel.bak) - 建议升级前先做一次全量备份导出
