星梦面板

// DOCS · 备份与还原 ▍

备份与还原

备份还原工具是一个免安装的命令行小工具：把面板的本地数据打包成带完整性校验的备份包，随时还原到本机或迁移到新设备。

本工具备份的是主控 ——即星梦面板桌面端保存在本机的数据（节点列表、云凭证、证书、备忘录、L2 配置等）， 不涉及被控服务器。被控上容器 / 数据库的备份是另一个功能，请在面板内使用「系统功能 → 计划任务」。

单文件免安装

无依赖、无需安装，下载即用

SHA-256 完整校验

备份包内置清单，还原前逐文件校验

还原前自动备份

动现有数据前，先自动留一份安全副本

01

下载工具

Windows

Windows 10 / 11 · x86_64 · 命令行工具

下载 Windows 版（zip）xmp-backup-windows-amd64.exe.zip

请先解压再运行 ：zip 内含可执行文件与 SHA-256 校验文件，把 zip 解压到任意文件夹后，运行解压出来的程序。 不要在压缩软件窗口里直接双击运行——那样备份文件会生成到临时目录，关闭压缩软件后就找不到了。 （下载 zip 而非 exe，是为了避免浏览器拦截。）

也可以直接下载 exe 文件 或 校验文件。

Linux

主流发行版桌面环境 · x86_64 · 命令行工具

下载并运行
curl -O https://node.xmpanel.cn/v3/backup/xmp-backup-linux-amd64
chmod +x xmp-backup-linux-amd64
./xmp-backup-linux-amd64

也可以直接下载 二进制文件 或 校验文件。

02

备份数据

在想存放备份的文件夹里运行解压出来的工具（双击 exe 或在终端执行），输入 1 选择备份，确认后备份包会生成在 星梦面板备份还原\备份目录。 备份前请先完全退出面板。

备份会话（输出有删减）
> 1
====== 备 份 ======
· 数据未启用加密，备份内容为明文。

数据目录：C:\Users\<你>\AppData\Roaming\xmp-desktop\data
待备份文件（5 个）：
  - .migrated                       0 B
  - matters\matters.json          54 B
  - xmp.db                         24 KB
  ...
确认开始备份？ (y/N): y
正在备份到：星梦面板备份还原\备份目录\星梦面板备份-20260907-225018.zip
  √ data/xmp.db (24.00 KB)
  ...
√ 备份完成。

文件名中的数字是日期与时间（如 20260907-225018），按时间排序即是最新备份。

03

还原数据

把要还原的备份 zip 放进 星梦面板备份还原\导入备份目录（只放一个），运行工具输入 2。工具会先完整校验备份包，再自动备份现有数据，最后才执行替换。

还原会话（输出有删减）
> 2
====== 还 原 ======
正在校验备份包：星梦面板备份还原\导入备份目录\星梦面板备份-20260907-225018.zip
√ 校验通过：5 个文件，备份创建于 2026-09-07 22:50:18，数据已启用加密

还原目标：C:\Users\<你>\AppData\Roaming\xmp-desktop\data
现有数据将先自动备份到「还原时自动备份」目录，然后被替换。
确认执行还原？ (y/N): y
正在自动备份当前数据…
  自动备份到：星梦面板备份还原\还原时自动备份\还原前自动备份-20260907-230101.zip
  √ 自动备份完成并校验通过。
√ 还原完成。

工具的工作目录 

当前目录/
└─ 星梦面板备份还原/
   ├─ 备份目录/          ← 手动备份的产出
   ├─ 导入备份目录/       ← 要还原的备份 zip 放这里（只放一个）
   └─ 还原时自动备份/     ← 每次还原前对现有数据的自动备份

菜单 3 可以在不还原的情况下单独校验任意一个备份包，逐文件核对 SHA-256。

04

常见问题

备份里包含哪些数据？

主控（面板桌面端）保存在本机的全部数据：节点列表、云凭证、证书、备忘录、L2 配置等（即 xmp.db 数据库与同目录文件），不含操作日志，也不包含被控服务器上的任何数据。

数据开启了加密，备份还能用吗？

可以。备份内容为密文，在本机还原后打开面板即可自动解密；换设备还原后，首次使用需输入恢复密钥（数据大屏 → 数据概览，页面顶部状态提示条 →「详情」→「使用恢复密钥」）。如果不确定还记得恢复密钥，建议先在面板内关闭加密后再备份。

还原会覆盖我现有的数据吗？

还原前工具会先把现有数据完整备份到「还原时自动备份」目录并回读校验，确认无误后才替换。想反悔时，把那份自动备份的 zip 移到「导入备份目录」再还原一次即可。

备份文件能手工修改吗？

不能。备份包内置逐文件 SHA-256 清单，任何改动（哪怕重新压缩）都会导致校验失败而拒绝还原，这是防篡改设计。

换操作系统迁移（Windows ↔ Linux）可以吗？

可以。备份内容与平台无关；在新系统装好面板后，用对应平台的备份还原工具还原即可。