chore: 將 NFS 備份腳本與還原說明納入版控（nfs_backup/）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-29 14:31:39 +08:00
parent bdbad0b3a4
commit 83c2d8f09e
3 changed files with 165 additions and 0 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -10,6 +10,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co

 - [`hospital_media_antmedia.md`](hospital_media_antmedia.md) — 主機完整運維筆記（容器一覽、Caddy、Ant Media、SSL 憑證、備份）
 - [`xensor_cydroned_edr.md`](xensor_cydroned_edr.md) — CyCraft Xensor EDR agent（`cydroned`）安裝方法、連線跳板與現況
+- [`nfs_backup/`](nfs_backup/) — 每日 NFS 自動備份腳本（`backup_all_to_nfs.sh`）與備份內容/還原說明（`README.md`）

 ## 伺服器操作

--- a/nfs_backup/README.md
+++ b/nfs_backup/README.md
@@ -0,0 +1,105 @@
+# 備份說明 — 主機 106.105.181.40（hospital_media）
+
+本目錄存放主機 `106.105.181.40` 各服務的**每日自動備份**。
+備份來源主機 SSH 別名：`hospital_media`。
+
+- NFS 來源：`hdsnas02.tpech.gov.tw:/TEL_BACKUP_NFS`
+- 主機掛載點：`/mnt/tel_backup_nfs`（本目錄即 `/mnt/tel_backup_nfs/106_105_181_40/`）
+- 備份腳本：主機上 `/opt/backup_all_to_nfs.sh`
+- 排程：`/etc/cron.d/backup-nfs`，每天 **03:30** 以 root 執行
+- 保留天數：**14 天**（更舊的自動刪除，可在腳本 `RETAIN_DAYS` 調整）
+- 紀錄檔：本目錄 `backup.log`
+
+## 目錄結構
+
+```
+106_105_181_40/
+├── README.md                  # 本文件
+├── backup.log                 # 每次備份的紀錄
+└── YYYYMMDD_HHMMSS/           # 每天一個資料夾（備份時間戳）
+    ├── caddy.tar.gz
+    ├── php.tar.gz
+    ├── php-staging.tar.gz
+    ├── phpmyadmin.tar.gz
+    ├── coturn.tar.gz
+    ├── antmedia_volume.tar.gz
+    └── mysql_all_databases.sql.gz
+```
+
+## 各檔案備份的是什麼
+
+| 檔案 | 內容 | 主機來源 | 對應容器 |
+|------|------|----------|----------|
+| `caddy.tar.gz` | Caddy 設定、SSL 憑證、`tel-server` 靜態檔 | `/opt/caddy` | `caddy` |
+| `php.tar.gz` | 正式環境 PHP 程式碼 | `/opt/php`（網站根：`www/`） | `php` |
+| `php-staging.tar.gz` | 測試環境 PHP 程式碼 | `/opt/php-staging` | `php-staging` |
+| `phpmyadmin.tar.gz` | phpMyAdmin compose 設定（無資料，stateless） | `/opt/phpmyadmin` | `phpmyadmin` |
+| `coturn.tar.gz` | TURN/STUN 設定 `turnserver.conf` | `/opt/coturn` | `coturn` |
+| `antmedia_volume.tar.gz` | Ant Media Server **實際資料卷**（串流設定、應用、錄影等） | docker volume `antmedia_volume`（容器內 `/usr/local/antmedia`） | `antmedia` |
+| `mysql_all_databases.sql.gz` | **所有資料庫**的邏輯匯出（含 `tpech_tel`、`myapp` 等） | `mysqldump --all-databases` | `mysql-container` |
+
+> 注意：NAS 啟用 root_squash，檔案 owner 會顯示 `nobody:nogroup`，屬正常現象。
+
+---
+
+# 還原方法
+
+> 以下指令都在主機 `106.105.181.40` 上以 root（`sudo`）執行。
+> 先設定要還原的備份時間戳，例如：
+> ```bash
+> BK=/mnt/tel_backup_nfs/106_105_181_40/20260629_142059
+> ```
+
+## 1. 檔案型服務（Caddy / PHP / PHP-staging / phpMyAdmin / Coturn）
+
+解壓回 `/opt`（會覆蓋現有檔案），再重啟容器：
+
+```bash
+# 範例：還原 Caddy
+sudo tar xzf "$BK/caddy.tar.gz" -C /opt
+cd /opt/caddy && ./restart.sh        # 或 docker restart caddy
+
+# 其餘服務同理（換檔名與容器名）：
+sudo tar xzf "$BK/php.tar.gz"         -C /opt && docker restart php
+sudo tar xzf "$BK/php-staging.tar.gz" -C /opt && docker restart php-staging
+sudo tar xzf "$BK/phpmyadmin.tar.gz"  -C /opt && docker restart phpmyadmin
+sudo tar xzf "$BK/coturn.tar.gz"      -C /opt && docker restart coturn
+```
+
+## 2. Ant Media Server（資料卷）
+
+必須先停容器，清空舊資料卷再解壓，避免殘留檔案：
+
+```bash
+docker stop antmedia
+VOL=/var/lib/docker/volumes/antmedia_volume/_data
+sudo rm -rf "$VOL"/*                       # 清空（確認 BK 正確再執行！）
+sudo tar xzf "$BK/antmedia_volume.tar.gz" -C "$VOL"
+docker start antmedia
+```
+
+## 3. MySQL（所有資料庫）
+
+把 dump 灌回執行中的容器（會覆蓋同名資料庫）：
+
+```bash
+zcat "$BK/mysql_all_databases.sql.gz" | \
+  docker exec -i mysql-container sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD"'
+```
+
+只還原單一資料庫：
+
+```bash
+# 先從整包過濾出該 DB（或用 sed 擷取對應段落），簡單作法是全部灌回後只保留需要的
+zcat "$BK/mysql_all_databases.sql.gz" | \
+  docker exec -i mysql-container sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD" tpech_tel'
+# ↑ 注意：dump 為 --all-databases 格式，含 USE 語句；指定單庫還原前請確認段落，
+#   或改用 mysqldump 重新針對單一資料庫匯出。
+```
+
+## 還原後檢查
+
+- 容器狀態：`docker ps`
+- Caddy 設定語法：`docker exec caddy caddy validate --config /etc/caddy/Caddyfile`
+- MySQL：`docker exec -it mysql-container mysql -uroot -p"$MYSQL_ROOT_PASSWORD" -e 'SHOW DATABASES;'`
+- Ant Media：瀏覽器開管理介面確認應用與設定
--- a/nfs_backup/backup_all_to_nfs.sh
+++ b/nfs_backup/backup_all_to_nfs.sh
@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# 每日備份主機 106.105.181.40 各服務到 NAS NFS（hdsnas02:/TEL_BACKUP_NFS）
+# 由 cron 以 root 執行（見 /etc/cron.d/backup-nfs）
+# 手動執行：sudo /opt/backup_all_to_nfs.sh
+set -u
+
+NFS=/mnt/tel_backup_nfs
+BASE=$NFS/106_105_181_40
+RETAIN_DAYS=14                       # 保留天數，超過即刪除
+TS=$(date +%Y%m%d_%H%M%S)
+DEST=$BASE/$TS
+LOG=$BASE/backup.log
+
+log(){ echo "[$(date '+%F %T')] $*" | tee -a "$LOG"; }
+
+# 安全檢查：NFS 一定要掛載，否則中止（避免寫進本機根磁碟把它撐爆）
+if ! mountpoint -q "$NFS"; then
+  echo "[$(date '+%F %T')] ERROR: $NFS 未掛載，中止備份" | tee -a "$LOG" >&2
+  exit 1
+fi
+
+mkdir -p "$DEST"
+log "===== 備份開始 -> $DEST ====="
+ok=0; fail=0
+
+# do_tar <名稱> <來源上層目錄> <項目>
+do_tar(){
+  if tar czf "$DEST/$1.tar.gz" -C "$2" "$3" 2>"$DEST/$1.err"; then
+    log "$1 OK $(du -h "$DEST/$1.tar.gz" | cut -f1)"; rm -f "$DEST/$1.err"; ok=$((ok+1))
+  else
+    log "$1 FAIL: $(cat "$DEST/$1.err")"; fail=$((fail+1))
+  fi
+}
+
+do_tar caddy           /opt caddy
+do_tar php             /opt php
+do_tar php-staging     /opt php-staging
+do_tar phpmyadmin      /opt phpmyadmin
+do_tar coturn          /opt coturn
+do_tar antmedia_volume /var/lib/docker/volumes/antmedia_volume/_data .
+
+# MySQL：邏輯備份（--single-transaction = InnoDB 一致性快照，不鎖表）
+# 密碼從容器內環境變數取，不出現在主機 process list
+if docker exec mysql-container sh -c \
+    'exec mysqldump -uroot -p"$MYSQL_ROOT_PASSWORD" --all-databases --single-transaction --routines --triggers --events' \
+    2>"$DEST/mysql.err" | gzip > "$DEST/mysql_all_databases.sql.gz" \
+   && [ -s "$DEST/mysql_all_databases.sql.gz" ]; then
+  log "mysql OK $(du -h "$DEST/mysql_all_databases.sql.gz" | cut -f1)"; rm -f "$DEST/mysql.err"; ok=$((ok+1))
+else
+  log "mysql FAIL: $(cat "$DEST/mysql.err" 2>/dev/null)"; fail=$((fail+1))
+fi
+
+log "===== 完成：成功 $ok / 失敗 $fail，本次大小 $(du -sh "$DEST" | cut -f1) ====="
+
+# 保留天數內，清掉更舊的備份
+find "$BASE" -maxdepth 1 -type d -name '20*' -mtime +"$RETAIN_DAYS" -exec rm -rf {} \; 2>/dev/null
+log "===== 已清理超過 ${RETAIN_DAYS} 天的舊備份 ====="
+
+[ "$fail" -eq 0 ] || exit 1