数据备份与灾难恢复完全指南

# ── 打包压缩备份（全量）────────────────────────────────────────────────────
# -c: 创建归档  -z: gzip 压缩  -v: 显示进度  -f: 指定文件名
tar -czvf /backup/website_$(date +%Y%m%d).tar.gz /var/www/html

# 多目录同时备份（一次打包多个路径）
tar -czvf /backup/full_$(date +%Y%m%d).tar.gz   /var/www/html   /etc/nginx   /opt/myapp

# 解压恢复（-C / 表示解压到根目录，还原绝对路径）
tar -xzvf /backup/website_20260316.tar.gz -C /

# 查看压缩包内容（不解压，先检查）
tar -tzvf /backup/website_20260316.tar.gz | head -20

# ── rsync 增量同步（只传输变更的文件，适合大目录）────────────────────────
# -a: 归档模式（保留权限/时间戳/符号链接）
# -v: 显示传输详情
# -z: 传输时压缩（节省带宽）
# --delete: 删除目标端在源端已删除的文件（保持镜像同步）
# --exclude: 排除不需要备份的路径

rsync -avz --delete   --exclude='*.log'   --exclude='cache/'   --exclude='tmp/'   /var/www/html/   /backup/website_sync/

# 远程同步（将本地目录备份到另一台服务器）
rsync -avz -e "ssh -p 22"   /var/www/html/   backup_user@备份服务器IP:/remote/backup/website/

# 查看本次同步传输了哪些文件（dry-run 模式，不实际传输）
rsync -avzn --delete /var/www/html/ /backup/website_sync/

# ── 原生 MySQL 备份 ──────────────────────────────────────────────────────────
# --single-transaction: InnoDB 热备，不锁表，适合生产环境
# --routines: 包含存储过程  --events: 包含事件
mysqldump   --single-transaction   --routines   --events   -u root -p'your_password'   --all-databases   | gzip > /backup/mysql_all_$(date +%Y%m%d).sql.gz

# 只备份单个数据库
mysqldump -u root -p'your_password' myapp_db   | gzip > /backup/myapp_$(date +%Y%m%d).sql.gz

# ── Docker 容器内的 MySQL 备份（无需进入容器）─────────────────────────────────
# 直接在宿主机执行，通过管道重定向到宿主机文件
docker exec db_mysql mysqldump   -u root -p'your_password'   --single-transaction   --all-databases   | gzip > /backup/mysql_docker_$(date +%Y%m%d).sql.gz

# ── PostgreSQL 备份 ───────────────────────────────────────────────────────────
# 原生
sudo -u postgres pg_dumpall | gzip > /backup/pg_all_$(date +%Y%m%d).sql.gz

# Docker 容器内 PostgreSQL
docker exec db_postgres pg_dumpall -U postgres   | gzip > /backup/pg_docker_$(date +%Y%m%d).sql.gz

# ── 方式一：备份 Named Volume（命名卷）─────────────────────────────────────
# 使用临时容器挂载卷并打包导出

# 备份 nextcloud_data 卷
docker run --rm   -v nextcloud_data:/source:ro   -v /backup:/dest   alpine   tar czf /dest/nextcloud_data_$(date +%Y%m%d).tar.gz -C /source .

# 恢复：将备份解压回命名卷
docker run --rm   -v nextcloud_data:/dest   -v /backup:/source   alpine   tar xzf /source/nextcloud_data_20260316.tar.gz -C /dest

# ── 方式二：备份 Bind Mount 目录（绑定挂载）──────────────────────────────────
# Bind mount 的数据直接在宿主机目录，正常用 tar/rsync 备份即可
# 例如 Nextcloud 挂载到 /opt/nextcloud/data：
tar -czvf /backup/nextcloud_files_$(date +%Y%m%d).tar.gz /opt/nextcloud/data

# ── Mailcow 官方备份（推荐）───────────────────────────────────────────────────
cd /opt/mailcow-dockerized
./helper-scripts/backup_and_restore.sh backup all
# 备份文件存储在 /opt/mailcow-dockerized/backup/ 目录下

# ── 安装 Rclone ───────────────────────────────────────────────────────────────
curl https://rclone.org/install.sh | sudo bash

# ── 配置 Cloudflare R2（免费 10GB，出站流量免费）────────────────────────────
rclone config
# 选择 n（新建）→ 命名为 r2
# 选择存储类型：S3（Cloudflare R2 兼容 S3 API）
# provider: Cloudflare
# access_key_id: 在 CF R2 后台生成 API Token（R2 Token）
# secret_access_key: 对应的 Secret
# endpoint: https://账户ID.r2.cloudflarestorage.com
# 其余留空，完成配置

# ── 常用 Rclone 命令 ──────────────────────────────────────────────────────────
# 单向同步（本地 → 云端，删除云端多余文件）
rclone sync /backup/ r2:my-bucket/vps-backup/   --transfers=4   --checkers=8   --progress

# 只复制（不删除云端文件，安全）
rclone copy /backup/ r2:my-bucket/vps-backup/ --progress

# 列出云端文件
rclone ls r2:my-bucket/vps-backup/ | tail -20

# 从云端恢复（将云端备份下载到本地）
rclone copy r2:my-bucket/vps-backup/ /restore/ --progress

# ── 测试配置是否正常 ──────────────────────────────────────────────────────────
rclone lsd r2:my-bucket   # 列出存储桶目录
rclone about r2:          # 查看配额使用情况

# ── 安装 Restic ───────────────────────────────────────────────────────────────
# Ubuntu / Debian
apt install restic -y

# 或从 GitHub 下载最新版（功能更新更快）
wget https://github.com/restic/restic/releases/latest/download/restic_linux_amd64.bz2
bunzip2 restic_linux_amd64.bz2 && chmod +x restic_linux_amd64
mv restic_linux_amd64 /usr/local/bin/restic

# ── 初始化备份仓库（首次使用）────────────────────────────────────────────────
# 本地仓库
restic init --repo /backup/restic-repo

# Cloudflare R2 仓库（通过 S3 兼容 API）
export AWS_ACCESS_KEY_ID=你的R2_AccessKey
export AWS_SECRET_ACCESS_KEY=你的R2_SecretKey
restic -r s3:https://账户ID.r2.cloudflarestorage.com/bucket-name init

# ── 执行备份 ──────────────────────────────────────────────────────────────────
restic -r /backup/restic-repo backup /var/www/html /etc/nginx
# 首次备份创建快照，后续只存储变更的数据块（去重！）

# ── 查看所有快照 ──────────────────────────────────────────────────────────────
restic -r /backup/restic-repo snapshots

# ── 恢复指定快照 ──────────────────────────────────────────────────────────────
restic -r /backup/restic-repo restore latest --target /restore/

# ── 自动清理旧快照（保留策略）─────────────────────────────────────────────────
# 保留最近 7 天每日快照、4 周每周快照、12 月每月快照
restic -r /backup/restic-repo forget   --keep-daily 7   --keep-weekly 4   --keep-monthly 12   --prune

#!/bin/bash
# ════════════════════════════════════════════════════════════════════
#  VPS 全自动化备份脚本 v2.0
#  功能：文件备份 + 数据库备份 + Docker 卷备份 + 云端同步 + 告警通知
# ════════════════════════════════════════════════════════════════════
set -euo pipefail   # 任何命令失败立即退出

# ── 配置区（根据实际情况修改）────────────────────────────────────────────────
BACKUP_DIR="/root/backups"
WEB_DIR="/var/www/html"
DOCKER_DB_CONTAINER="db_mysql"
DB_USER="root"
DB_PASS="your_db_password"
DB_NAME="myapp_db"
RCLONE_REMOTE="r2:my-bucket/vps-backup"
RETAIN_DAYS=14
TELEGRAM_TOKEN=""         # 可选：Telegram Bot Token（填写后发送告警）
TELEGRAM_CHAT_ID=""       # 可选：Telegram Chat ID
LOG_FILE="/var/log/backup.log"
DATE=$(date +"%Y-%m-%d_%H-%M-%S")

# ── 工具函数 ──────────────────────────────────────────────────────────────────
log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" | tee -a "$LOG_FILE"; }

notify() {
  if [[ -n "$TELEGRAM_TOKEN" && -n "$TELEGRAM_CHAT_ID" ]]; then
    curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_TOKEN}/sendMessage"       -d "chat_id=${TELEGRAM_CHAT_ID}"       -d "text=$1" > /dev/null 2>&1 || true
  fi
}

# 捕获错误并发送告警
trap 'notify "❌ VPS 备份失败！服务器：$(hostname) 时间：$(date)" ; log "ERROR: 备份任务异常退出"' ERR

# ── 开始执行 ──────────────────────────────────────────────────────────────────
log "=== 开始备份任务 DATE=$DATE ==="
mkdir -p "$BACKUP_DIR"

# 1. 网站文件备份
log "① 打包网站文件..."
tar -czf "${BACKUP_DIR}/web_${DATE}.tar.gz" "$WEB_DIR" 2>>$LOG_FILE
log "   完成：$(du -sh ${BACKUP_DIR}/web_${DATE}.tar.gz | cut -f1)"

# 2. Docker MySQL 数据库备份
log "② 导出 MySQL 数据库..."
docker exec "$DOCKER_DB_CONTAINER" mysqldump   -u "$DB_USER" -p"$DB_PASS"   --single-transaction "$DB_NAME"   | gzip > "${BACKUP_DIR}/db_${DATE}.sql.gz"
log "   完成：$(du -sh ${BACKUP_DIR}/db_${DATE}.sql.gz | cut -f1)"

# 3. 清理本地过期备份
log "③ 清理 ${RETAIN_DAYS} 天前的旧备份..."
find "$BACKUP_DIR" -type f ( -name "*.tar.gz" -o -name "*.sql.gz" )   -mtime "+${RETAIN_DAYS}" -delete
log "   清理完成"

# 4. Rclone 同步到云端
log "④ 同步到云存储 $RCLONE_REMOTE..."
rclone sync "$BACKUP_DIR/" "$RCLONE_REMOTE/"   --transfers=4   --log-file="$LOG_FILE"   --log-level=INFO
log "   同步完成"

# 5. 验证云端文件数量
CLOUD_COUNT=$(rclone ls "$RCLONE_REMOTE/" 2>/dev/null | wc -l)
log "   云端共 $CLOUD_COUNT 个备份文件"

log "=== 备份任务成功完成 ==="
notify "✅ VPS 备份成功！服务器：$(hostname) 云端文件数：$CLOUD_COUNT"

#!/bin/bash
# 每周执行一次备份完整性验证（防止备份文件损坏但浑然不知）
BACKUP_DIR="/root/backups"
ERRORS=0

echo "=== 备份文件完整性验证 ==="

# 检查 tar.gz 文件
for f in "$BACKUP_DIR"/*.tar.gz; do
  if gzip -t "$f" 2>/dev/null; then
    echo "✅ $f"
  else
    echo "❌ $f 损坏！"
    ERRORS=$((ERRORS + 1))
  fi
done

# 检查 sql.gz 文件（验证能否解压读取前100行）
for f in "$BACKUP_DIR"/*.sql.gz; do
  if gunzip -c "$f" 2>/dev/null | head -100 > /dev/null; then
    echo "✅ $f"
  else
    echo "❌ $f 损坏！"
    ERRORS=$((ERRORS + 1))
  fi
done

echo "=== 验证完成，发现 $ERRORS 个问题 ==="
exit $ERRORS

# ── Step 1：从云端拉回备份文件 ─────────────────────────────────────────────
# 新服务器上先安装 Rclone 并配置，然后下载最新备份
rclone copy r2:my-bucket/vps-backup/ /root/backups/ --progress
ls -lh /root/backups/   # 确认文件已下载

# ── Step 2：恢复网站文件 ──────────────────────────────────────────────────────
# -C / 确保按绝对路径还原到原始位置（/var/www/html）
tar -xzvf /root/backups/web_2026-03-16_04-00-00.tar.gz -C /
chown -R www-data:www-data /var/www/html   # 恢复文件权限

# ── Step 3：恢复 MySQL 数据库 ─────────────────────────────────────────────────
# 先确保数据库容器已启动
docker compose up -d db

# 等待 MySQL 就绪（约 10-20 秒）
sleep 15

# 导入备份（解压后通过管道导入）
gunzip -c /root/backups/db_2026-03-16_04-00-00.sql.gz   | docker exec -i db_mysql mysql -u root -p'your_password' myapp_db

# ── Step 4：验证恢复结果 ──────────────────────────────────────────────────────
# 检查网站文件数量
find /var/www/html -type f | wc -l

# 检查数据库表
docker exec db_mysql mysql -u root -p'your_password' myapp_db   -e "SHOW TABLES; SELECT COUNT(*) FROM users;"

# 启动所有服务
docker compose up -d