备份管理
标准版及以上商业版功能
校对日期:2026-11-17。需要商业版标准版及以上。
备份管理把模板、上传文件和数据库打包保存在程序所在的服务器上,需要时在控制台恢复。本页面向系统管理员和运维人员, 说明每种备份包含什么、文件放在哪里、恢复会覆盖什么,以及怎样定期自动备份。
一、四种备份
进入 文件 → 备份管理,四个页签各管一种备份:
| 页签 | 备份什么 | 备份文件 |
|---|---|---|
| 模板备份 | 模板存储点的全部文件,即所有站点的主题 | themes/ |
| 上传备份 | 附件存储点的全部文件,即所有站点上传的图片、视频和附件 | uploads/ |
| 上传增量备份 | 附件存储点相对之前各份备份的变化,见“上传增量备份”一节 | uploads-incremental/ |
| 数据库备份 | 整个数据库,由数据库自带的导出工具生成,见“数据库备份的准备”一节 | database/,其它数据库以类型开头,如 postgresql-20261117020000. |
存储点的含义见存储点的“四个存储点”一节;存储点在 FTP 服务器或对象存储上时同样可以备份和恢复。 文件名里的数字是做备份时服务器的日期和时间(年月日时分秒)。表中的路径相对于备份目录,即程序目录下的 WEB-INF/backup/: Jar 部署为 <部署目录>/,Tomcat 部署为 webapps/, Docker 为容器内的 /ujcms/(在挂载到 /ujcms/static 的卷里)。
备份不分站点。存储点是全局设置,数据库也只有一个,所以无论在哪个站点下操作,备份和恢复的都是整个系统的文件和数据。
以下内容不在任何一种备份里:静态页存储点里的静态页(可在 系统 → 生成管理 里重新生成)、主题包存储点里的主题安装包、 全文索引(可以重建)、配置文件 application.(数据库连接和各项密钥都在里面),以及备份目录本身。
二、数据库备份的准备
数据库备份调用数据库自带的命令行工具。使用之前在 application. 中确认两项,修改后重启程序:
# 数据库类型。支持 mysql(MariaDB 也填 mysql)、postgresql、kingbase(人大金仓)、opengauss
ujcms.database-type: mysql
# 命令行工具所在的目录。工具已在系统路径(PATH)里时留空
ujcms.database-bin-path:| 数据库类型 | 备份用的工具 | 恢复用的工具 | 备份文件 |
|---|---|---|---|
mysql | mysqldump | mysql | SQL 文本,压缩为 .sql.zip |
postgresql | pg_dump | psql、pg_restore | pg_dump 的 custom 格式,压缩为 .dump.zip |
kingbase | sys_dump | ksql、sys_restore | 同上 |
opengauss | gs_dump | gsql、gs_restore | 同上 |
- 工具装在程序所在的服务器上,不是数据库服务器上。工具按
spring.里的主机、端口、库名, 以及datasource. url spring.、datasource. username spring.连接数据库。工具的版本要与数据库服务器相配。datasource. password - PostgreSQL、人大金仓、openGauss 恢复时要删除并重建数据库:连接数据库的账号须是这个库的所有者并能创建数据库, 还要能连接默认库
postgres(人大金仓为test)。 - 达梦等其它数据库不能在这里备份,请用数据库自己的工具。
- Docker 镜像里装有 MySQL 的客户端工具,
UJCMS_DB_TYPE默认为mysql;使用 PostgreSQL 等数据库时,镜像里没有对应的工具, 要在自己构建的镜像里安装。见 Docker 部署。 - 工具输出的信息写在程序日志里,备份或恢复失败时先看日志。
三、备份与删除
- 进入 文件 → 备份管理,切换到要备份的页签。
- 点 备份,确认“您确定备份吗?”。完成后提示“成功”,列表里多出一个文件。
列表显示每个备份文件的 名称、修改日期 和 大小,不一定按时间先后排列,以文件名里的时间为准。
- 备份没有完成之前,列表里可能已经出现这个文件,大小还在变化;数据库备份先出现
.sql或.dump文件,导出完成后换成.zip。 这时不要恢复或删除它。 - 手动备份不会删除旧的备份。不再需要的,勾选后点上方的 删除,或点行内的 删除;定期清理用定时任务的 保留份数, 见“定期自动备份”一节。上传增量备份不能随意删除其中一份,见“上传增量备份”一节。
- 控制台不提供下载。要把备份保存到别处,直接复制服务器上备份目录里的文件,如用 SFTP 下载; Docker 部署可以用
docker cp <容器名>:。/ ujcms/ static/ WEB-INF/ backup . / backup
四、恢复
在要恢复的那一行点 恢复,确认“恢复操作将覆盖现有数据,且不可逆。您确定恢复吗?”。
恢复时网站照常运行,期间访客可能看到图片缺失或页面出错。请选在访问少、没有人编辑内容的时候进行,并且先对当前状态再做一份备份, 恢复错了还能退回。
| 页签 | 恢复时做什么 |
|---|---|
| 模板备份 | 先删除模板存储点里的全部文件,再把备份解压进去。备份之后新建、修改的模板都会丢失,备份之后安装的主题也会被删除 |
| 上传备份 | 先删除附件存储点里的全部文件,再把备份解压进去。备份之后上传的文件都会丢失 |
| 上传增量备份 | 见“上传增量备份”一节 |
| 数据库备份 | MySQL:用 mysql 命令导入备份,备份里的各张表恢复为备份时的内容。PostgreSQL、人大金仓、openGauss:先断开这个数据库的所有连接(包括程序自己的连接),删除并重新创建数据库,再导入备份 |
还要注意:
- 文件恢复到当前的存储点。备份之后改过存储点的,文件写到新的位置。
- 模板恢复只涉及文件,站点用哪个主题、页面编排等保存在数据库里,不随之改变。删除之前,模板等文本文件的内容会作为“删除” 记入编辑历史(文件很多时只记一部分),恢复错了可以在 设计 → 模板 里点 历史 逐个找回。
- 恢复数据库之后重启程序:程序缓存了一部分数据,不重启会继续显示恢复前的内容。重启后重建全文索引, 见全文检索的“重建索引”一节。
- 开启了静态化的站点,恢复模板或数据库后在 系统 → 生成管理 里重新生成静态页。
手工恢复:程序无法启动,或文件太多不能在控制台恢复时(见“常见问题”一节),先停止程序,在服务器上恢复:
- 模板备份、上传备份:压缩包内的目录结构与存储点相同,第一层是站点 ID(如
1/)。存储点为本地服务器时,清空它的存储路径 (默认为程序目录下的themes/、uploads/),再把压缩包解压到这个目录。 - 数据库备份:先解压出
.sql或.dump文件。MySQL 执行mysql -h 主机 -u 用户名 -p < mysql-20261117020000., 导出时带有建库语句,数据导入同名的数据库。PostgreSQL 先新建一个同名的空数据库,再执行sql pg_restore -h 主机 -U 用户名 -d 库名 postgresql-20261117020000.;人大金仓用dump sys_restore,openGauss 用gs_restore。 - 上传增量备份:要从最早的一份起依次解压,遇到以
.del结尾的删除标记还要删掉对应的文件,比较繁琐。需要手工恢复的场合,以上传备份为准。
五、上传增量备份
上传备份每次都打包全部附件,文件多时又慢又占空间。上传增量备份只打包变化的部分:
- 第一份包含附件存储点的全部文件,相当于一份上传备份。
- 之后每一份只包含新增的文件、修改时间比之前各份里更晚的文件、删除之后又重新上传的文件,以及删除标记:之前备份过、 现在已经不存在的文件,在包里记为一个以
.del结尾的空文件。是否变化只看文件的修改时间(精确到秒),不比较内容。
恢复:在某一份上点 恢复,先删除附件存储点里的全部文件,再从最早的一份起依次解压到选中的这一份为止,并按删除标记删除文件, 得到做这一份备份时的附件。每一份都依赖它之前的所有备份,所以不要单独删除其中的某一份,尤其是最早的一份,否则恢复出来的文件不完整。
合并:勾选两份或以上,点 合并,确认“您确定合并吗?”。从勾选的最早一份到最晚一份之间的全部备份(包括中间没有勾选的) 合并成一份,名称沿用最晚的那一份;合并之后,中间的时间点不能再单独恢复。合并不必从最早的一份开始: 范围之前还有备份时,范围内的删除标记会保留在合并后的包里,恢复时照样删除那些文件。
份数多了,也可以交给定时任务的 保留份数:超出时自动把最早的几份合并为一份,见下一节。
六、定期自动备份
在 系统 → 定时任务 里新增类型为 模板备份、上传备份、上传增量备份 或 数据库备份 的任务,按执行计划自动备份, 生成的文件同样出现在本页对应的页签里。做法见定时任务。
- 保留份数:每次备份成功后,这个页签里只保留最新的 N 份,更早的自动删除,手动备份的文件也算在内;上传增量备份则把最早的几份合并为一份。 填 0 或留空为不限。
- 备份类任务在专用线程里依次执行,执行期间状态为 运行中。备份不分站点,同一种备份建一个任务就够了。
- 安排备份只需要定时任务的权限,不需要本页的 备份 权限。
七、存放、安全与升级
- 备份文件包含整个系统的数据:数据库备份里有全部用户账号、密码摘要和各项设置,上传备份里有全部上传文件。
- 备份目录在程序目录的
WEB-INF下,程序不对外提供这个目录。用 Nginx 直接发送程序目录里的文件时,须在 Nginx 上禁止访问/WEB-INF/, 见 Nginx 反向代理的“由 Nginx 直接发送静态文件”一节。 - 备份与程序在同一台服务器上,服务器损坏时一起丢失。请定期把备份文件复制到其它机器保存。
- 数据库里的部分数据用配置文件里的
ujcms.加密,用户密码与data-secret-key ujcms.有关。这两项不在备份里, 要与备份分开保管;在另一台服务器上恢复时须使用相同的值,见等保三级与密评三级合规配置的“密钥管理”一节。password-pepper - MySQL、openGauss 的数据库密码以命令行参数传给导出、导入工具,备份和恢复进行期间,服务器上的其他用户能在进程列表里看到它; PostgreSQL、人大金仓通过环境变量传递。
- 集群部署时,备份文件写在处理这次操作(或执行定时任务)的节点上,列表也只显示该节点的文件, 见集群部署的“本地目录与节点依赖”一节。
升级之前要备份数据库和整个部署目录。在这里做的数据库备份就在部署目录里,升级前把它复制到部署目录之外。 升级时保留备份目录:Jar 部署保留 static/WEB-INF/,Tomcat 部署把 WEB-INF/backup/ 复制回新的 ROOT,Docker 的备份在卷里。 升级之后不要在新版本里恢复升级之前的数据库备份,那里面是旧版本的表结构;要退回升级前的状态,停止程序,按“恢复”一节手工导入升级前的备份, 再换回旧版本的程序。
八、权限
在 用户 → 角色管理 的权限树里,文件 下的 备份管理 节点有 模板备份、上传备份、上传增量备份、数据库备份 四个子节点, 各有 列表、备份、恢复、删除 四项,上传增量备份 另有 合并。
- 有某种备份的 列表 权限才显示它的页签;没有 备份、恢复、删除、合并 权限时,对应的按钮不可点。
- 功能权限在用户能进入的每个站点里都一样,而备份和恢复作用于整个系统。这些权限,尤其是 恢复,只给系统管理员。
- 备份、恢复、合并、删除都记入 日志 → 操作日志。
九、常见问题
- 备份或恢复要等很久。 控制台一直等到服务器做完,再提示“成功”或出错的原因;期间不要重复点击,也不要关闭页面。 程序前面有 Nginx 等反向代理时,代理的读超时(Nginx 的
proxy_,见Nginx 反向代理的“基本配置:全部转发给程序”一节) 要长于备份、恢复所需的时间,否则请求被代理切断,控制台提示出错(如 504),而服务器上的备份或恢复仍在继续,稍后刷新页面查看列表。 文件多、数据库大的,也可以改用定时任务的 立即执行,在定时任务列表里看执行状态。read_ timeout - 提示“数据库备份失败,请检查数据库命令行工具路径(ujcms.database-bin-path)及日志”或“数据库恢复失败,……”。 导出、导入工具运行了,但没有成功,原因在程序日志里。常见的是
ujcms.与实际的数据库不符、账号权限不足、 工具与数据库服务器的版本不配。定时任务遇到这种情况同样记为失败。database-type - 提示里有
Cannot run program。 程序找不到导出、导入工具,在ujcms.填写工具所在的目录, 见“数据库备份的准备”一节。database-bin-path - 提示里有
This database does not support backup,或定时任务提示“当前数据库类型不支持备份:…”。ujcms.不是database-type mysql、postgresql、kingbase、opengauss之一。 - 恢复到一半报错,提示里有
Archive contains too many entries。 一个备份文件里的文件和文件夹合计超过 10 万个,控制台不能恢复。 此时存储点里的文件已经删除,按“恢复”一节的手工恢复办法解压。附件很多的站点,平时就要按手工恢复做好准备。 - 恢复数据库之后,后台和前台仍显示原来的内容,或者出错。 重启程序,再重建全文索引。
- 集群里备份列表时有时无。 备份文件只在生成它的节点上,请求落到不同节点时看到的列表不同,见“存放、安全与升级”一节。
- 备份占满了磁盘。 手动备份不会自动清理。删除旧的备份,或用定时任务的 保留份数 控制份数;上传增量备份用 合并,不要直接删除。
- “合并”按钮是灰的。 至少要勾选两份上传增量备份,并且有 合并 权限。
相关文档
- 定时任务:定期自动备份与保留份数。
- 存储点:模板存储点、附件存储点在哪里。
- 升级:升级前的备份,升级时保留哪些目录。
- 集群部署:多节点时备份目录的处理。
- 等保三级与密评三级合规配置:备份与异地保存的要求。