From 3724221a77174d3ce8582123eee815fc31cde40a Mon Sep 17 00:00:00 2001
From: k <k@admin.k>
Date: Mon, 22 Dec 2025 15:34:55 +0000
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 324 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 324 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d9b2e8a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,324 @@
+# MySQL 8.0.24 备份恢复工具集
+
+一套完整的 MySQL 8.0.24 备份恢复解决方案，包含全量备份、增量备份、恢复脚本及自动化测试。
+
+## 📁 项目结构
+
+```
+mysql-backup-scripts/
+├── config.sh                  # 配置文件
+├── lib/
+│   └── common.sh             # 公共函数库
+├── full_backup.sh            # 全量备份脚本
+├── incremental_backup.sh     # 增量备份脚本
+├── restore_full.sh           # 全量备份恢复脚本
+├── restore_incremental.sh    # 增量备份恢复脚本
+├── test_backup_restore.sh    # 自动化测试脚本
+└── README.md                 # 本文档
+```
+
+## 🚀 快速开始
+
+### 1. 配置
+
+编辑 `config.sh` 文件，根据实际环境修改以下配置：
+
+```bash
+# MySQL 连接配置
+MYSQL_HOST="localhost"
+MYSQL_PORT="3306"
+MYSQL_USER="root"
+MYSQL_PASSWORD="your_password"
+
+# 备份存储配置
+BACKUP_ROOT_DIR="/data/mysql_backup"
+```
+
+### 2. 设置脚本权限
+
+```bash
+chmod +x *.sh
+chmod +x lib/*.sh
+```
+
+### 3. 执行备份
+
+```bash
+# 全量备份所有数据库
+./full_backup.sh
+
+# 全量备份指定数据库
+./full_backup.sh -d mydb
+
+# 增量备份
+./incremental_backup.sh
+```
+
+## 📋 脚本说明
+
+### 全量备份 (full_backup.sh)
+
+使用 `mysqldump` 进行逻辑全量备份。
+
+**功能特点：**
+- 支持单数据库或所有数据库备份
+- 记录 binlog 位置用于后续增量备份
+- 支持压缩备份（gzip/pigz/lz4）
+- 自动清理过期备份
+- 完善的错误处理和日志记录
+
+**使用方法：**
+```bash
+./full_backup.sh [选项]
+
+选项：
+  -d, --database <name>    指定要备份的数据库 (可多次使用)
+  -c, --compress           启用压缩 (默认)
+  -n, --no-compress        禁用压缩
+  -h, --help               显示帮助信息
+
+示例：
+  ./full_backup.sh                     # 备份所有数据库
+  ./full_backup.sh -d mydb             # 仅备份 mydb 数据库
+  ./full_backup.sh -d db1 -d db2       # 备份多个指定数据库
+```
+
+### 增量备份 (incremental_backup.sh)
+
+基于 MySQL binlog 的增量备份。
+
+**功能特点：**
+- 基于 binlog 实现增量备份
+- 从上次全量/增量备份点开始备份
+- 支持压缩
+- 自动清理过期备份
+
+**前提条件：**
+- 必须先执行过全量备份
+- MySQL 必须启用 binlog (`log_bin=ON`)
+- MySQL 用户需要 `REPLICATION SLAVE`, `REPLICATION CLIENT` 权限
+
+**使用方法：**
+```bash
+./incremental_backup.sh [选项]
+
+选项：
+  -f, --full-backup <path>  指定全量备份基准目录
+  -b, --base-backup <path>  指定增量备份基准目录 (用于增量链)
+  -c, --compress            启用压缩 (默认)
+  -n, --no-compress         禁用压缩
+  -h, --help                显示帮助信息
+
+示例：
+  ./incremental_backup.sh                          # 基于最新全量备份
+  ./incremental_backup.sh -f /path/to/full_backup  # 指定全量备份
+```
+
+### 全量备份恢复 (restore_full.sh)
+
+从全量备份恢复数据库。
+
+**功能特点：**
+- 支持恢复全部数据库或指定数据库
+- 自动解压压缩备份
+- 恢复前可选择性备份当前数据
+- 支持验证恢复结果
+
+**使用方法：**
+```bash
+./restore_full.sh [选项] <备份目录>
+
+选项：
+  -d, --database <name>    仅恢复指定数据库
+  -y, --yes                跳过确认提示
+  --no-backup              恢复前不备份当前数据
+  -h, --help               显示帮助信息
+
+示例：
+  ./restore_full.sh /path/to/backup
+  ./restore_full.sh -d mydb /path/to/backup
+  ./restore_full.sh -y --no-backup /path/to/backup
+```
+
+### 增量备份恢复 (restore_incremental.sh)
+
+应用增量备份中的 binlog。
+
+**功能特点：**
+- 基于 binlog 应用增量变更
+- 支持指定时间点恢复 (PITR)
+- 自动处理备份链
+
+**使用方法：**
+```bash
+./restore_incremental.sh [选项] <增量备份目录>
+
+选项：
+  -d, --database <name>       仅恢复指定数据库
+  -t, --stop-datetime <time>  指定恢复到的时间点 (格式: 'YYYY-MM-DD HH:MM:SS')
+  -y, --yes                   跳过确认提示
+  -h, --help                  显示帮助信息
+
+示例：
+  ./restore_incremental.sh /path/to/incr_backup
+  ./restore_incremental.sh -t '2023-12-20 15:30:00' /path/to/incr_backup
+```
+
+### 自动化测试 (test_backup_restore.sh)
+
+自动化测试备份和恢复功能。
+
+**测试流程：**
+1. 创建测试数据库和测试数据
+2. 执行全量备份
+3. 添加增量数据
+4. 执行增量备份
+5. 删除测试数据库（模拟数据丢失）
+6. 从全量备份恢复
+7. 应用增量备份
+8. 验证数据完整性
+9. 清理测试数据
+
+**使用方法：**
+```bash
+./test_backup_restore.sh [选项]
+
+选项：
+  --skip-cleanup    测试后不清理数据
+  --verbose         显示详细输出
+  -h, --help        显示帮助信息
+```
+
+## 📂 备份目录结构
+
+```
+/data/mysql_backup/
+├── full/                                    # 全量备份目录
+│   └── mysql_backup_full_20231220_120000/  # 单次全量备份
+│       ├── all_databases.sql.gz            # 全库备份文件
+│       ├── binlog_position.txt             # binlog 位置
+│       └── metadata.txt                    # 备份元数据
+├── incremental/                             # 增量备份目录
+│   └── mysql_backup_incr_20231220_180000/  # 单次增量备份
+│       ├── mysql-bin.000001.gz             # binlog 备份
+│       ├── binlog_position.txt             # binlog 位置
+│       ├── base_backup_path.txt            # 基准备份路径
+│       └── metadata.txt                    # 备份元数据
+├── logs/                                    # 日志目录
+│   ├── full_backup_20231220_120000.log
+│   └── incremental_backup_20231220_180000.log
+└── restore_tmp/                             # 恢复临时目录
+```
+
+## ⚙️ MySQL 配置要求
+
+为了支持增量备份，需要在 MySQL 配置文件 (my.cnf) 中启用 binlog：
+
+```ini
+[mysqld]
+# 启用 binlog
+log_bin = mysql-bin
+server-id = 1
+binlog_format = ROW
+
+# 可选：设置 binlog 过期时间
+expire_logs_days = 7
+# 或者在 MySQL 8.0 中使用
+binlog_expire_logs_seconds = 604800
+```
+
+## 🔐 MySQL 用户权限
+
+备份用户需要以下权限：
+
+```sql
+GRANT SELECT, SHOW VIEW, TRIGGER, LOCK TABLES, RELOAD, 
+      REPLICATION CLIENT, REPLICATION SLAVE, EVENT, PROCESS 
+ON *.* TO 'backup_user'@'localhost';
+```
+
+## 🔄 典型恢复流程
+
+### 场景 1：完全恢复
+
+```bash
+# 1. 恢复最新的全量备份
+./restore_full.sh /data/mysql_backup/full/mysql_backup_full_20231220_120000
+
+# 2. 按顺序应用所有增量备份
+./restore_incremental.sh /data/mysql_backup/incremental/mysql_backup_incr_20231220_180000
+./restore_incremental.sh /data/mysql_backup/incremental/mysql_backup_incr_20231221_060000
+```
+
+### 场景 2：时间点恢复 (PITR)
+
+```bash
+# 1. 恢复全量备份
+./restore_full.sh /data/mysql_backup/full/mysql_backup_full_20231220_120000
+
+# 2. 应用增量备份到指定时间点
+./restore_incremental.sh -t '2023-12-20 15:30:00' /data/mysql_backup/incremental/mysql_backup_incr_20231220_180000
+```
+
+### 场景 3：单数据库恢复
+
+```bash
+# 1. 恢复指定数据库的全量备份
+./restore_full.sh -d mydb /data/mysql_backup/full/mysql_backup_full_20231220_120000
+
+# 2. 应用增量备份
+./restore_incremental.sh -d mydb /data/mysql_backup/incremental/mysql_backup_incr_20231220_180000
+```
+
+## ⏰ 定时任务配置
+
+推荐的 crontab 配置：
+
+```cron
+# 每天凌晨 2 点执行全量备份
+0 2 * * * /path/to/mysql-backup-scripts/full_backup.sh >> /var/log/mysql_backup.log 2>&1
+
+# 每隔 6 小时执行增量备份 (除了全量备份时间)
+0 8,14,20 * * * /path/to/mysql-backup-scripts/incremental_backup.sh >> /var/log/mysql_backup.log 2>&1
+```
+
+## 🐛 错误处理
+
+所有脚本都包含完善的错误处理：
+
+1. **连接错误**：无法连接 MySQL 时会输出详细错误信息
+2. **权限错误**：权限不足时会提示所需权限
+3. **磁盘空间**：备份前检查磁盘空间是否充足
+4. **锁定机制**：防止同时运行多个备份进程
+5. **日志记录**：所有操作都记录到日志文件
+
+## 📝 日志示例
+
+```
+[INFO] [2023-12-20 12:00:00] ============================================================
+[INFO] [2023-12-20 12:00:00] MySQL 全量备份开始
+[INFO] [2023-12-20 12:00:00] ============================================================
+[INFO] [2023-12-20 12:00:00] 检查 MySQL 连接...
+[INFO] [2023-12-20 12:00:00] MySQL 连接成功
+[INFO] [2023-12-20 12:00:00] 记录 binlog 位置信息
+[INFO] [2023-12-20 12:00:00] Binlog 位置: mysql-bin.000005:12345
+[INFO] [2023-12-20 12:00:01] 备份所有数据库
+[INFO] [2023-12-20 12:05:00] 全库备份完成，大小: 2.5G
+[INFO] [2023-12-20 12:05:00] 备份验证通过
+[INFO] [2023-12-20 12:05:00] ============================================================
+[INFO] [2023-12-20 12:05:00] MySQL 全量备份完成
+[INFO] [2023-12-20 12:05:00] 执行耗时: 00:05:00
+[INFO] [2023-12-20 12:05:00] ============================================================
+```
+
+## ⚠️ 注意事项
+
+1. **生产环境使用前请充分测试**
+2. **建议在低峰期执行全量备份**
+3. **定期验证备份可恢复性**
+4. **保持备份存储的安全性**
+5. **监控备份任务的执行状态**
+
+## 📄 许可证
+
+MIT License