#!/usr/bin/env bash # ============================================================================= # rollback.sh —— 从 /var/backups 的完整快照精确还原线上 custom/ 与 app.ini # # ./scripts/rollback.sh --list # ./scripts/rollback.sh <备份文件> # 交互确认 # ./scripts/rollback.sh --yes <备份文件> # 自动确认(供 deploy.sh 失败回滚) # ./scripts/rollback.sh --allow-incomplete <旧备份> # 允许缺少 QQ 主题的历史备份 # ============================================================================= set -euo pipefail BACKUP_DIR="/var/backups" DST_CUSTOM="/var/lib/gitea/custom" APP_INI="/etc/gitea/app.ini" STAMP="$(date +%Y%m%d-%H%M%S)" DO_IT=0 ALLOW_INCOMPLETE=0 BACKUP="" say() { printf '\033[36m==>\033[0m %s\n' "$*"; } warn() { printf '\033[33m[!]\033[0m %s\n' "$*"; } fail() { printf '\033[31m[错误]\033[0m %s\n' "$*" >&2; exit 1; } for arg in "$@"; do case "$arg" in --yes) DO_IT=1 ;; --allow-incomplete) ALLOW_INCOMPLETE=1 ;; --list) ;; -h|--help) sed -n '2,9p' "$0" exit 0 ;; -*) fail "未知参数:$arg" ;; *) [ -z "$BACKUP" ] || fail "只能指定一个备份文件" BACKUP="$arg" ;; esac done if [ -z "$BACKUP" ]; then echo "可用备份(新的在上):" ls -1t "$BACKUP_DIR"/gitea-custom-*.tar.gz 2>/dev/null || echo " (没有找到备份)" echo echo "还原用法:./scripts/rollback.sh $BACKUP_DIR/gitea-custom-<时间戳>.tar.gz" exit 0 fi [ -f "$BACKUP" ] || fail "备份不存在:$BACKUP" say "校验备份完整性" sudo tar tzf "$BACKUP" >/dev/null if sudo tar tzf "$BACKUP" | grep -E '(^/|(^|/)\.\.(/|$))' >/dev/null; then fail "备份包含不安全路径,拒绝解包" fi for required in \ var/lib/gitea/custom/templates/base/footer_content.tmpl \ var/lib/gitea/custom/public/assets/css/qq-pages.css \ etc/gitea/app.ini; do sudo tar tzf "$BACKUP" | grep -Fx "$required" >/dev/null || fail "备份缺少关键文件:$required" done missing_themes=0 for theme in theme-qq-auto.css theme-qq-light.css theme-qq-dark.css; do if ! sudo tar tzf "$BACKUP" | grep -Fx "var/lib/gitea/custom/public/assets/css/$theme" >/dev/null; then warn "备份缺少 $theme" missing_themes=1 fi done if [ "$missing_themes" -eq 1 ] && [ "$ALLOW_INCOMPLETE" -ne 1 ]; then fail "这是历史不完整备份。默认拒绝精确回滚;确认承担主题文件缺失风险后才可加 --allow-incomplete" fi if [ "$DO_IT" -ne 1 ]; then echo "将精确还原 $BACKUP:" echo " 1) 先完整备份当前 custom/ 与 app.ini" echo " 2) 解包到临时目录并再次校验" echo " 3) 停止 Gitea,以 rsync --delete 精确还原 custom/" echo " 4) 还原 app.ini、权限并启动 Gitea" read -r -p "确认还原?(y/N) " ans [ "$ans" = "y" ] || [ "$ans" = "Y" ] || { echo "已取消"; exit 0; } fi TMP_DIR="$(mktemp -d)" trap 'sudo rm -rf "$TMP_DIR"' EXIT sudo tar xzf "$BACKUP" -C "$TMP_DIR" SRC_CUSTOM="$TMP_DIR/var/lib/gitea/custom" SRC_APP_INI="$TMP_DIR/etc/gitea/app.ini" [ -d "$SRC_CUSTOM" ] || fail "解包后找不到 custom/" [ -f "$SRC_APP_INI" ] || fail "解包后找不到 app.ini" SAFETY_BACKUP="$BACKUP_DIR/gitea-pre-rollback-$STAMP.tar.gz" say "回滚前保护当前状态:$SAFETY_BACKUP" sudo tar czf "$SAFETY_BACKUP" -C / var/lib/gitea/custom etc/gitea/app.ini sudo chmod 600 "$SAFETY_BACKUP" say "停止 Gitea 并精确还原" sudo systemctl stop gitea sudo mkdir -p "$DST_CUSTOM" sudo rsync -a --delete "$SRC_CUSTOM/" "$DST_CUSTOM/" sudo cp -a "$SRC_APP_INI" "$APP_INI" sudo chown -R git:git "$DST_CUSTOM" sudo systemctl start gitea sleep 2 if ! systemctl is-active --quiet gitea; then fail "Gitea 未能启动;回滚前状态保存在 $SAFETY_BACKUP" fi if command -v curl >/dev/null && ! curl -fsS -o /dev/null https://git.qyhhh.top/; then fail "Gitea 已启动但站点健康检查失败;回滚前状态保存在 $SAFETY_BACKUP" fi say "还原完成,Gitea 运行正常" echo "回滚前状态备份:$SAFETY_BACKUP"