数据备份与恢复

数据备份用于在误操作、服务器故障、磁盘损坏或迁移时能找回数据。后台「数据备份」下有三个页面:

建议把它理解成两层保护:先在本机生成备份文件(快),再同步到异地(防止服务器整体损坏时备份一起丢失)。远程同步不能替代本地备份,因为它同步的就是本地备份目录里的文件。

使用前准备 #

本地备份 #

基本配置 #

改完后必须点击「保存配置」才生效。

本地保存目录 #

默认值为 /data/backups/facai-cms。保存配置或立即备份时系统会检查目录:不存在会尝试创建,不可写会提示错误。不要填上传资源目录或临时目录。

保留策略 #

普通站点用「按备份数保留」保留 7–14 份;内容更新频繁、文件大的站点用「按空间上限」。有远程同步时也不要关闭本地保留策略:本地旧文件被清理时,远程端同名旧文件也会按当前远程配置处理。

加密备份 #

开启「启用加密备份」并填写加密密码后,备份文件为 .tar.gz.enc。密码要妥善保存(忘记就无法使用),不要和后台登录密码相同;改密码只影响之后新生成的备份,旧备份仍要用当时的密码。需要把备份同步到第三方存储时强烈建议启用。

备份内容 #

日常完整备份三项都选。

立即备份 #

点击「立即备份」会弹窗确认,可临时调整本次的保存目录、是否包含上传资源/系统配置;这些修改只对本次生效,不改写配置。启用了加密但没填密码时会被拦截;已有备份或同步在执行时需等待完成。

远程同步 #

同步策略 #

「立即同步」只同步本地备份目录中最新的一个备份文件,不会重新生成备份;没有本地备份文件时先去做一次本地备份;它使用已保存的配置,页面上刚改未保存的内容不参与。

远程类型与填写项 #

保存前先点「测试连接」,它会检查地址、账号、目录/桶是否可用,以及是否有写入和删除测试文件的权限(不会保存配置)。测试通过只代表当时可用,正式启用后仍要定期看备份日志。

备份日志 #

可按备份类型(全部/本地备份/远程同步)、执行状态(全部/成功/执行中/失败)、开始时间筛选。字段包括任务编号(向技术支持反馈问题时提供)、类型、状态、文件大小、耗时、开始/完成时间,「查看详情」可看目标位置、文件名和失败原因。「执行中」请稍后刷新。

数据恢复 #

恢复是高风险操作,请由熟悉服务器的人在命令行执行。

备份包里有什么 #

本地备份文件名形如 local-YYYYMMDDHHMMSS-随机串.tar.gz(加密后多一个 .enc 后缀)。解压后的目录结构:

恢复前检查 #

确认备份来源、时间点、文件大小(明显异常不要直接恢复)、是否加密(准备密码)、包含哪些内容。恢复前先额外保存一份当前状态,方便回退;并进入维护模式或停止服务,避免恢复过程中产生新数据。

建议顺序 #

1. 通知相关人员,确认恢复窗口;
2. 停止服务:systemctl stop facy.service(或开启维护模式);
3. 把备份文件复制到临时目录(远程备份先下载回来);
4. 如果是加密备份,先解密(见下);
5. 解压:tar -xzf local-xxxx.tar.gz -C /tmp/restore;
6. 先恢复数据库:用 pg_restore 把 database/database.dump 导入目标库(库名、账号见 facyManager db show),例如 pg_restore -h localhost -p 5432 -U 用户名 -d 库名 --clean --if-exists /tmp/restore/database/database.dump;
7. 再按需把 uploads/ 内容放回静态资源目录;
8. 最后按需恢复 config/ 里的系统配置;
9. systemctl start facy.service(或退出维护模式);
10. 登录后台和前台检查,成功后立即重新做一次本地备份和远程同步。

f=local-xxxx.tar.gz.enc
K=$(printf %s 'secret' | sha256sum | cut -d' ' -f1)
IV=$(tail -c +10 "$f" | head -c 16 | od -An -tx1 | tr -d ' \n')
tail -c +26 "$f" | openssl enc -d -aes-256-ctr -K "$K" -iv "$IV" > restored.tar.gz
tar -tzf restored.tar.gz | head   # 能列出 database/ uploads/ config/ 说明密码正确