增加备份

2026-05-17 09:28:18 +08:00
parent e7f24b5bb6
commit bded31a7e7
16 changed files with 568 additions and 9 deletions
@@ -37,6 +37,11 @@ DB_PATH=crypto.db
 # 交易截图上传目录
 UPLOAD_DIR=static/images

+# 自动备份（scripts/backup_data.sh + cron，可选；默认即可）
+# BACKUP_ROOT=/root/backups
+# BACKUP_RETENTION_DAYS=30
+# BACKUP_INSTANCE=crypto_monitor_gate_bot
+
 # 已废弃：资金账户仅显示交易所 funding 余额，不再读取此变量
 # TOTAL_CAPITAL=100
 # 每天起始基数（U）
@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# Daily backup: SQLite DB + static/images → /root/backups/<instance>/<YYYY-MM-DD>/
+# Prune backup folders older than RETENTION_DAYS (default 30).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_DIR"
+
+BACKUP_ROOT="${BACKUP_ROOT:-/root/backups}"
+RETENTION_DAYS="${RETENTION_DAYS:-30}"
+INSTANCE_NAME="${BACKUP_INSTANCE:-$(basename "$PROJECT_DIR")}"
+TZ_NAME="${BACKUP_TZ:-Asia/Shanghai}"
+
+log() {
+  printf '[%s] %s\n' "$(TZ="$TZ_NAME" date '+%Y-%m-%d %H:%M:%S %Z')" "$*"
+}
+
+read_env_var() {
+  local key="$1"
+  local default="$2"
+  local line
+  if [[ ! -f .env ]]; then
+    printf '%s' "$default"
+    return
+  fi
+  line="$(grep -E "^${key}=" .env 2>/dev/null | tail -1 || true)"
+  if [[ -z "$line" ]]; then
+    printf '%s' "$default"
+    return
+  fi
+  printf '%s' "${line#*=}" | tr -d '\r'
+}
+
+resolve_project_path() {
+  local p="$1"
+  if [[ "$p" == /* ]]; then
+    printf '%s' "$p"
+  else
+    printf '%s' "$PROJECT_DIR/$p"
+  fi
+}
+
+prune_old_backups() {
+  local base="$BACKUP_ROOT/$INSTANCE_NAME"
+  [[ -d "$base" ]] || return 0
+  local cutoff
+  cutoff="$(TZ="$TZ_NAME" date -d "-${RETENTION_DAYS} days" +%Y-%m-%d 2>/dev/null || true)"
+  if [[ -z "$cutoff" ]]; then
+    find "$base" -mindepth 1 -maxdepth 1 -type d -mtime +"$RETENTION_DAYS" -print0 |
+      xargs -r -0 rm -rf
+    return 0
+  fi
+  local dir name
+  for dir in "$base"/*/; do
+    [[ -d "$dir" ]] || continue
+    name="$(basename "$dir")"
+    [[ "$name" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || continue
+    if [[ "$name" < "$cutoff" ]]; then
+      log "prune: remove $dir (older than ${RETENTION_DAYS} days)"
+      rm -rf "$dir"
+    fi
+  done
+}
+
+DB_REL="$(read_env_var DB_PATH crypto.db)"
+UPLOAD_REL="$(read_env_var UPLOAD_DIR static/images)"
+BACKUP_ROOT="$(read_env_var BACKUP_ROOT "$BACKUP_ROOT")"
+RETENTION_DAYS="$(read_env_var BACKUP_RETENTION_DAYS "$RETENTION_DAYS")"
+INSTANCE_NAME="$(read_env_var BACKUP_INSTANCE "$INSTANCE_NAME")"
+
+DB_PATH="$(resolve_project_path "$DB_REL")"
+UPLOAD_DIR="$(resolve_project_path "$UPLOAD_REL")"
+DATE_TAG="$(TZ="$TZ_NAME" date +%Y-%m-%d)"
+DEST="$BACKUP_ROOT/$INSTANCE_NAME/$DATE_TAG"
+
+if [[ ! -f "$DB_PATH" ]]; then
+  log "error: database not found: $DB_PATH"
+  exit 1
+fi
+
+mkdir -p "$DEST"
+log "start backup instance=$INSTANCE_NAME dest=$DEST"
+
+if command -v sqlite3 >/dev/null 2>&1; then
+  sqlite3 "$DB_PATH" ".backup '$DEST/crypto.db'"
+  log "db: sqlite3 backup -> $DEST/crypto.db"
+else
+  cp -a "$DB_PATH" "$DEST/crypto.db"
+  log "db: cp -> $DEST/crypto.db (sqlite3 not installed)"
+fi
+
+if [[ -d "$UPLOAD_DIR" ]]; then
+  tar -czf "$DEST/static_images.tar.gz" -C "$(dirname "$UPLOAD_DIR")" "$(basename "$UPLOAD_DIR")"
+  log "images: $UPLOAD_DIR -> $DEST/static_images.tar.gz"
+else
+  log "warn: upload dir missing, skip images: $UPLOAD_DIR"
+fi
+
+{
+  echo "instance=$INSTANCE_NAME"
+  echo "project_dir=$PROJECT_DIR"
+  echo "backup_date=$DATE_TAG"
+  echo "db_path=$DB_PATH"
+  echo "upload_dir=$UPLOAD_DIR"
+} >"$DEST/manifest.txt"
+
+prune_old_backups
+log "done"
@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Install daily backup cron: Beijing 00:00 (CRON_TZ=Asia/Shanghai).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+BACKUP_SCRIPT="$SCRIPT_DIR/backup_data.sh"
+INSTANCE_NAME="${BACKUP_INSTANCE:-$(basename "$PROJECT_DIR")}"
+LOG_FILE="${BACKUP_CRON_LOG:-/var/log/crypto-monitor-backup-${INSTANCE_NAME}.log}"
+
+if [[ ! -x "$BACKUP_SCRIPT" ]]; then
+  chmod +x "$BACKUP_SCRIPT"
+fi
+
+TMP="$(mktemp)"
+trap 'rm -f "$TMP"' EXIT
+
+{
+  crontab -l 2>/dev/null | grep -vF "$BACKUP_SCRIPT" || true
+  echo "CRON_TZ=Asia/Shanghai"
+  echo "0 0 * * * $BACKUP_SCRIPT >> $LOG_FILE 2>&1"
+} >"$TMP"
+
+awk '
+  BEGIN { tz = 0 }
+  /^CRON_TZ=Asia\/Shanghai$/ {
+    if (tz++) next
+  }
+  { print }
+' "$TMP" >"${TMP}.2"
+mv "${TMP}.2" "$TMP"
+
+crontab "$TMP"
+echo "Installed cron for $INSTANCE_NAME"
+echo "  Schedule : daily 00:00 Asia/Shanghai"
+echo "  Script   : $BACKUP_SCRIPT"
+echo "  Log      : $LOG_FILE"
+crontab -l | grep -F "$BACKUP_SCRIPT" || true
@@ -138,7 +138,22 @@ nano .env
 - **升级前备份**：`cp .env .env.backup.$(date +%Y%m%d)`；恢复：`cp .env.backup.YYYYMMDD .env`。
 - **换机**：`scp` 复制 `.env`，或新机 `cp .env.example .env` 后重填。

-### 5.3 必填项检查（Gate + 代理）
+### 5.3 自动备份（数据库 + 复盘图片）
+
+每天 **北京时间 0:00** 备份到 **`/root/backups`**，保留 **30 天**（`crypto.db` + `static/images`）。
+
+```bash
+cd /opt/crypto_monitor/crypto_monitor_gate_bot
+chmod +x scripts/backup_data.sh scripts/install_backup_cron.sh
+bash scripts/install_backup_cron.sh
+bash scripts/backup_data.sh   # 试跑
+```
+
+备份目录：`/root/backups/crypto_monitor_gate_bot/YYYY-MM-DD/`。与 Binance / Gate 实例规则相同，详见 `crypto_monitor_binance/部署文档.md` 第 5.3 节（恢复步骤、可选 `.env` 变量）。
+
+若服务器同时跑 **binance、gate、gate_bot** 三个实例，请在**各自项目目录**各执行一次 `install_backup_cron.sh`。
+
+### 5.4 必填项检查（Gate + 代理）

 与交易所相关的变量必须是 **Gate** 前缀（**不要**再写 OKX 变量，否则代理不会生效、密钥也不会被识别）。至少确认：