中国 帮助

备份与安全

哪些数据丢了会真的痛、各自怎么备、恢复顺序,以及公开部署之前必须做的脱敏项。

备份与安全
封面

> 本文整理自平台文档 docs/wujies/5.x/deploy/ops/backup-security.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-534bc7d5d720-cover.svg)

这份文档回答两个问题:丢了什么会真的痛,以及公开部署之前必须做哪些脱敏。

---

要备份什么

分两类:数据库表与文件。每项都标了「丢了会怎样」—— 按这个后果排优先级,不要按体积排。

### 数据库表

对象内容丢了会怎样
app_install这台部署装了哪些应用、装的是哪个版本、状态(enabled / disabled / uninstalled)不知道本机该有那些应用。菜单的隐藏逻辑依赖「有没有已启用安装实例」,菜单会整体显示异常;升级/卸载失去入口
app_install_task安装/升级/卸载的步骤与日志丢掉的是审计线索与排查依据。注意它是刻意保留的,包含「彻底删除」之后的历史记录(应用名显示「(应用已删除)」)
app_version_menu版本 → 菜单的归属映射(version_id / menu_id / menu_key)菜单归属信息丢失。菜单同步会失去「复用既有 menu_id」的依据,升级时会建出一套重复菜单;「彻底删除」也找不到该删哪些菜单行
app_schema_history迁移账本:(app_code, script) → 摘要 / 成功标记 / 耗时最痛的一项,见下一节
目录表 app_info / app_version / app_category / app_plan(+ app_dependency)本机这一份目录:只装内置模块与开发台『本地安装』登记的行(未配中心地址时市场读的就是它)丢的是本部署自己那份。已发布的应用与版本自 2026-10-30 起由中心上架服务(独立部署的 wujies-market,库名 wujies_market,4 张表)持有 —— 那套库要单独备,不在本部署的卷里

应用包的迁移脚本是按目录驱动执行的:扫到脚本 → 对比账本里的摘要 → 没执行过就执行。账本丢了会同时发生两件坏事:

1. 已经跑过的 DDL 会被再跑一遍。幂等脚本(CREATE TABLE IF NOT EXISTS)能扛住,但不幂等的脚本会直接失败,更糟的是「加列」这类脚本如果没做判断,第二次执行就会报错并让升级卡死。 2. checksum 校验失去基准。「已执行过的脚本内容不能再改」这条保护完全依赖账本里记的摘要 —— 账本丢了,改过的脚本会被当新脚本执行。

反过来说,「彻底删除」时删掉这个应用的迁移记录是刻意的:不删的话重装时建表脚本会被当成「已执行过」跳过,结果是装成功了但所有页面报表不存在。备份与这里并不矛盾:备份是为了灾难恢复,删除是为了让重装能真正重建。

### 文件

对象内容丢了会怎样
<应用仓库>/keys/(尤其 private.pem)包签名私钥丢了没法找回,只能重新生成一对新钥;旧钥签过的包全部作废,必须重签一遍,并且所有部署都要更新公钥并重启。这个目录已 gitignore(12 个应用仓库里已有的 11 个放的是同一对,wujies-cms-plugin 还没建),所以它只存在于你的机器上
plugins-dist/后端插件 jar 落位目录 + active-plugins.txt可恢复:重新从市场拉包落位(「我的应用」里点部署,或重装/升级)。但要注意 active-plugins.txt 记录「当前该用哪个 jar」,丢了之后重启加载会退化成扫描目录
wujies-admin/app-market-dist/remote-apps/前端远程应用产物(每个 appCode 一个目录)可恢复:同上,重新部署即可。丢了的表现是 /remote-apps/<code>/index.js 404、菜单点开是「远程视图不可用」
对象存储里的安装包各版本的 .zip中心目录里的 package_url 指向它。丢了就没法安装/部署该版本 —— 所以私钥与已发布包要一起归档(重签需要原始包)

「就地重签」需要原始的、未被改动的包。只备私钥、不备已发布的包,换钥/补签时就得从对象存储里捞 —— 如果对象存储也一起出事,那些版本只能重新打包上传成新版本。

---

密钥纪律

规则说明
私钥只留在发布方各应用仓库的 keys/ 已加进 .gitignore。私钥一旦进仓库,任何人都能签出被后端认可的包,签名就完全白做了
仓库之外要有备份密码管理器、CI 的 secret、离线的加密归档都可以。私钥丢了没有找回的办法,只能重新生成
绝不覆盖已有私钥keygen 遇到目录里已存在 private.pem(或 public.pem)会直接拒绝。换钥是破坏性操作,必须显式做
公钥不是秘密它放在 app-market.security.public-key 里没有安全问题 —— 它只回答「这个包是不是这把私钥签的」
正式发布前就备份好换钥的代价取决于已经签过多少包:旧钥签过的全部作废

### 换钥要同时做三件事

1. 重新生成密钥对(旧私钥丢了就只能重来)。

``powershell # 在该应用仓库根执行(11 个仓库与母本共用同一对钥,换钥要逐仓生成或手工同步) powershell -NoProfile -ExecutionPolicy Bypass -File .\package.ps1 -Keygen ``

2. 把新的 public.pem 整段贴进 app-market.security.public-key(生成命令会把可粘贴的 YAML 片段打印出来;也可以加 -SyncPublicKey 让脚本直接改 yml)。 3. 重建宿主并重启。

公钥是启动期读进内存的。只改 yml 不重建、不重启,后端还在用旧公钥 —— enforce 模式下会把你刚签的包全部拒掉,而报错看起来像「签名无效」,极容易往错的方向查。

还有一层:application.yml 是打在宿主 jar 里的,所以必须 mvn -pl wujies-admin -am -B install -DskipTests 重建 jar,再重启。⚠️ 动手前先停掉正在运行的宿主进程 —— 在别人正在跑的 JVM 上 mvn install 会让它按需懒解析到已被清掉的类,直接 NoClassDefFoundError。

换钥之后别忘了:所有已签名的包都要重签(就地重签,版本号与状态都不动),并用 GET /app/install/signature-readiness 确认 ready=true。流程见 [密钥与签名](/docs/wujies/5.x/platform/package/signing)。

---

公开部署前的脱敏清单

下面每一项在公开部署前都要换成新生成的值,并且不要出现在任何文档、聊天记录、截图、工单里。本页不贴任何真实值,只写占位符。

#位置要换什么备注
1数据库连接(spring.datasource)用户名 / 密码 / 主机 / 库名1Panel 安装时库名与账号是 random: true 随机生成的(默认前缀 wujies ⇒ wujies_xxxxxx,调度中心那份是 wujies-job_xxxxxx),本身就不是弱口令;外部库要自己保证
2Redis(spring.data.redis)密码 / 主机面板里那个 Redis 没设密码时安装表单的密码栏是空的,而它是必填项 —— 先去面板设个密码
3Sa-Token JWT 密钥sa-token.jwt-secret-key换掉之后所有已签发的 token 失效,所有人都要重新登录
4api-decrypt 公私钥api-decrypt.publicKey / privateKey与前端 VITE_APP_... 那对是配套的,必须成对替换
5签名公钥app-market.security.public-key换成你自己的那把(见上一节)。注意它换掉就意味着要重建宿主 + 重启 + 重签旧包
6前端 .env.* 的接口地址VITE_APP_BASE_API 等用示例/占位符替换真实域名。不要把当前环境的域名留在仓库里:.env.production 现在把它写成绝对地址(为此后端放开了 CORS),/prod-api 同源形式在同一文件里注释保留 —— 换成你自己的域名,或直接改回同源形式
7对象存储凭据sys_oss_config 表里的 AK/SK、endpoint、bucket它存在数据库里,不在 yml。脱敏时容易漏
8监控中心 / 调度中心的账号密码安装表单里的值监控中心默认账号 wujies(口令取根

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-534bc7d5d720-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容