LighthouseApp/MySQL-Backup-Guide.md

MySQL 5.7 自动备份指南

📋 配置说明

🔧 需要修改的配置项

在 docker-compose-mysql-backup.yml 文件中，请修改以下配置：

environment:
  # 🔗 远程 MySQL 5.7 服务器配置
  MYSQL_HOST: "your-mysql-server.com"        # ← 修改为你的MySQL服务器地址
  MYSQL_PORT: "3306"                         # ← 修改为你的MySQL端口
  MYSQL_USER: "backup_user"                  # ← 修改为你的备份用户
  MYSQL_PASSWORD: "backup_password"          # ← 修改为你的备份密码
  MYSQL_VERSION: "5.7"                       # ← MySQL版本 (已设置为5.7)
  
  # 📁 备份配置
  BACKUP_RETENTION_DAYS: "7"                 # ← 备份保留天数
  BACKUP_SCHEDULE: "0 2 * * *"               # ← 备份时间 (每天凌晨2点)
  
  # 🔧 备份选项
  BACKUP_TYPE: "full"                        # ← 备份类型: full(全量) / incremental(增量)
  COMPRESS_BACKUP: "true"                    # ← 是否压缩备份
  PARALLEL_THREADS: "2"                      # ← 并行线程数 (MySQL 5.7 建议使用较少线程)

🚀 执行步骤

步骤1: 准备环境

# 1. 创建必要的目录
mkdir -p backup logs scripts monitor

# 2. 设置目录权限
chmod 755 backup logs scripts monitor

步骤2: 修改配置

# 编辑配置文件
nano docker-compose-mysql-backup.yml

# 或者使用 vim
vim docker-compose-mysql-backup.yml

重要: 请将以下配置修改为你的实际信息：

• MYSQL_HOST: 你的MySQL服务器地址
• MYSQL_PORT: MySQL端口 (通常是3306)
• MYSQL_USER: 备份用户账号
• MYSQL_PASSWORD: 备份用户密码

步骤3: 启动备份服务

# 启动备份服务
docker-compose -f docker-compose-mysql-backup.yml up -d

# 查看服务状态
docker-compose -f docker-compose-mysql-backup.yml ps

步骤4: 验证备份

# 查看备份日志
docker-compose -f docker-compose-mysql-backup.yml logs -f mysql-backup

# 查看备份文件
ls -la backup/

# 手动触发备份 (可选)
docker-compose -f docker-compose-mysql-backup.yml exec mysql-backup /scripts/backup.sh

步骤5: 访问监控界面

# 访问监控界面
open http://localhost:8080
# 或者
curl http://localhost:8080

📊 备份时间配置

常用时间配置

# 每天凌晨2点备份
BACKUP_SCHEDULE: "0 2 * * *"

# 每6小时备份一次
BACKUP_SCHEDULE: "0 */6 * * *"

# 每周日凌晨2点备份
BACKUP_SCHEDULE: "0 2 * * 0"

# 每月1日凌晨2点备份
BACKUP_SCHEDULE: "0 2 1 * *"

# 每天上午8点和晚上8点备份
BACKUP_SCHEDULE: "0 8,20 * * *"

时间格式说明

# crontab 格式: 分 时 日 月 周
# 分: 0-59
# 时: 0-23
# 日: 1-31
# 月: 1-12
# 周: 0-7 (0和7都表示周日)

🔍 故障排除

常见问题

1. 连接失败

# 检查网络连接
ping your-mysql-server.com

# 检查端口是否开放
telnet your-mysql-server.com 3306

# 查看详细错误日志
docker-compose -f docker-compose-mysql-backup.yml logs mysql-backup

2. 权限问题

# 检查目录权限
ls -la backup/ logs/ scripts/

# 修复权限
chmod 755 backup/ logs/ scripts/
chown -R $USER:$USER backup/ logs/ scripts/

3. 备份失败

# 查看详细日志
docker-compose -f docker-compose-mysql-backup.yml logs mysql-backup

# 手动测试连接
docker-compose -f docker-compose-mysql-backup.yml exec mysql-backup \
  mysql -h your-mysql-server.com -P 3306 -u backup_user -p

日志分析

# 实时查看日志
docker-compose -f docker-compose-mysql-backup.yml logs -f mysql-backup

# 查看最近的日志
docker-compose -f docker-compose-mysql-backup.yml logs --tail=100 mysql-backup

# 查看特定时间的日志
docker-compose -f docker-compose-mysql-backup.yml logs --since="2024-01-15T00:00:00" mysql-backup

📁 备份文件结构

backup/
├── full/                    # 全量备份目录
│   ├── 20240115_020000/    # 按时间戳命名的备份目录
│   │   └── backup.tar.gz   # 压缩的备份文件
│   └── 20240116_020000/
│       └── backup.tar.gz
└── incremental/             # 增量备份目录
    ├── 20240115_140000/
    │   └── backup.tar.gz
    └── 20240115_200000/
        └── backup.tar.gz

🔧 高级配置

自定义备份脚本

# 创建自定义备份脚本
cat > scripts/custom-backup.sh << 'EOF'
#!/bin/bash
# 自定义备份逻辑
echo "执行自定义备份..."
# 在这里添加你的自定义逻辑
EOF

chmod +x scripts/custom-backup.sh

备份到云存储

# 安装云存储工具
docker-compose -f docker-compose-mysql-backup.yml exec mysql-backup \
  apt-get update && apt-get install -y awscli

# 配置云存储
docker-compose -f docker-compose-mysql-backup.yml exec mysql-backup \
  aws configure

📞 支持

如果遇到问题，请检查：

1. 网络连接: 确保可以访问MySQL服务器
2. 用户权限: 确保备份用户有足够权限
3. 磁盘空间: 确保有足够的存储空间
4. 日志文件: 查看详细的错误日志

🎯 总结

这个配置提供了：

• ✅ 自动备份: 定时自动执行备份
• ✅ MySQL 5.7 支持: 使用兼容的Percona XtraBackup 2.4
• ✅ 压缩备份: 节省存储空间
• ✅ 自动清理: 自动删除旧备份
• ✅ 监控界面: Web界面查看备份状态
• ✅ 详细日志: 完整的备份日志记录
• ✅ 错误处理: 完善的错误检测和处理

按照上述步骤配置后，你的MySQL 5.7数据库将自动进行定时备份！