website-scripts/backup/README.md

备份与恢复

统一备份恢复工具，支持远程（从本地 Mac 操作服务器）和本地（直接在服务器上执行）两种模式。

快速上手

# 备份
bash scripts/backup/backup.sh                        # 站点完整备份（推荐）
bash scripts/backup/backup.sh --db-only               # 仅数据库
bash scripts/backup/backup.sh --full                  # 灾难备份
bash scripts/backup/backup.sh assets monitor          # 仅指定站点

# 恢复
bash scripts/backup/restore.sh                        # 交互式恢复
bash scripts/backup/restore.sh 20260708_120000        # 指定时间戳
bash scripts/backup/restore.sh --db monitor file.db   # 数据库恢复
bash scripts/backup/restore.sh --full backup.tar.gz   # 灾难恢复

远程 vs 本地模式

	远程模式（默认）	本地模式 --local
执行位置	本地 Mac	服务器上
Docker 操作	ssh txjp "docker ..."	直接 docker ...
文件传输	scp	本地 cp
适用场景	日常运维	灾难恢复 / 新服务器

# 远程（默认）
bash scripts/backup/backup.sh

# 本地
bash scripts/backup/backup.sh --local
bash scripts/backup/restore.sh --local --full full-backup.tar.gz

新服务器灾难恢复流程

# 1. 在新服务器上安装 Docker + Compose V2

# 2. 上传脚本和备份文件
scp scripts/backup/*.sh user@new-server:/root/docker/scripts/backup/
scp full-backup-20260708.tar.gz user@new-server:/root/docker/

# 3. 在新服务器上执行本地恢复
ssh user@new-server
cd /root/docker && bash scripts/backup/restore.sh --local --full full-backup-20260708.tar.gz

备份内容

站点	备份项
assets	assets.db + uploads/ + docker-compose.yml + .env + Dockerfile
issue	issue.db + uploads/ + reports/ + docker-compose.yml + .env + Dockerfile
ldap	users.db + docker-compose.yml + .env + Dockerfile
gitea	gitea.db + git仓库/ + conf/ + docker-compose.yml
monitor	monitor.db + docker-compose.yml + .env
oa	docker-compose.yml + .env（无独立数据库）
shared	nginx配置 + SSL证书 + Docker网络配置

备份存储

位置	路径
本地	/Users/niuniu/programs/docker/db-backups/
云端	/root/docker/db-backups/

自动备份

# 每天凌晨 3 点
0 3 * * * cd /Users/niuniu/programs/docker && bash scripts/backup/backup.sh

新增站点

无需修改脚本——自动发现 *-ai/docker-compose.yml 中含 DB 的站点。新站点只需在 backup.sh 的 case 语句中添加专用备份逻辑（或走 wildcard 通用备份）。

注意事项

• 备份前自动执行 WAL checkpoint，确保数据库完整性
• 恢复会重启相关容器，短暂影响服务
• Gitea 代码仓库备份较大（~130M），可单独调整备份频率
• --full 灾难备份不含 uploads 等动态文件，仅保存数据库 + 代码仓库 + 配置
• 建议定期验证备份文件可恢复性