Skip to content

备份与迁移 ​

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)
  • 建议升级前先做一次全量备份导出

相关 ​

基于 AGPL-3.0 协议发布