#!/usr/bin/env bash # ============================================================================= # 备份正在运行的 Docker 栈 (PostgreSQL + Gitea 数据) # # ./backup.sh # 在线备份(不中断服务) # ./backup.sh --quiesce # 先停 gitea 容器再备份, 得到一致快照 # # 产物: deploy/backups/<时间戳>/ # postgres-.dump pg_dump 自定义格式 # gitea-data.tar.gz GITEA_DATA_DIR 全量打包 # MANIFEST.txt 版本/大小/时间 # SHA256SUMS 校验和 # ============================================================================= set -euo pipefail DEPLOY_DIR=$(cd "$(dirname "$0")/.." && pwd) cd "$DEPLOY_DIR" QUIESCE=0 case "${1:-}" in --quiesce) QUIESCE=1 ;; -h|--help) sed -n '2,14p' "$0"; exit 0 ;; "") ;; *) echo "未知参数: $1" >&2; exit 2 ;; esac [[ -f .env ]] || { echo "错误: 缺少 .env" >&2; exit 1; } # 逐行读取 .env, 不做 shell 展开($$ 还原为 $) while IFS= read -r line || [[ -n "$line" ]]; do [[ "$line" =~ ^[[:space:]]*(#|$) ]] && continue key=${line%%=*}; val=${line#*=} key=${key//[[:space:]]/} [[ "$val" == \"*\" || "$val" == \'*\' ]] && val=${val:1:-1} val=${val//\$\$/\$} export "${key}=${val}" done < .env : "${POSTGRES_DB:?}"; : "${POSTGRES_USER:?}"; : "${GITEA_DATA_DIR:?}" if ! docker compose ps --status running --format '{{.Service}}' 2>/dev/null | grep -q '^db$'; then echo "错误: db 容器未运行, 先 docker compose up -d" >&2 exit 1 fi STAMP=$(date +%Y%m%d-%H%M%S) OUT="${BACKUP_DIR:-$DEPLOY_DIR/backups}/$STAMP" mkdir -p "$OUT" echo "==> 备份目录: $OUT" if [[ ${QUIESCE} -eq 1 ]]; then echo "==> 暂停 gitea 容器以保证数据一致" docker compose stop gitea fi echo "==> pg_dump ${POSTGRES_DB}" docker compose exec -T db pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc \ > "$OUT/postgres-${POSTGRES_DB}.dump" echo "==> 打包 Gitea 数据目录 ${GITEA_DATA_DIR}" tar -C "$(dirname "$GITEA_DATA_DIR")" -czf "$OUT/gitea-data.tar.gz" "$(basename "$GITEA_DATA_DIR")" if [[ ${QUIESCE} -eq 1 ]]; then echo "==> 恢复 gitea 容器" docker compose start gitea fi { echo "created_at: $(date -Is)" echo "hostname: $(hostname)" echo "gitea_image: $(docker compose config --format json 2>/dev/null | grep -o '"image"[^,]*' | head -1 || true)" echo "postgres_db: ${POSTGRES_DB}" echo "gitea_data_dir: ${GITEA_DATA_DIR}" echo "quiesced: ${QUIESCE}" echo du -h "$OUT"/* 2>/dev/null || true } > "$OUT/MANIFEST.txt" ( cd "$OUT" && sha256sum ./* > SHA256SUMS ) echo "==> 完成" cat "$OUT/MANIFEST.txt" echo echo "恢复数据库:" echo " docker compose exec -T db pg_restore -U ${POSTGRES_USER} -d ${POSTGRES_DB} --clean --if-exists < $OUT/postgres-${POSTGRES_DB}.dump" echo "恢复数据目录:" echo " docker compose stop gitea && tar -C $(dirname "$GITEA_DATA_DIR") -xzf $OUT/gitea-data.tar.gz && docker compose start gitea"