1. 项目概述

MySQL主从复制是数据库高可用架构的基础配置，传统手工部署至少需要半天时间配置和调试。而使用Docker Compose，我们可以在5分钟内完成一套完整的主从集群搭建。这种方案特别适合开发测试环境快速搭建、CI/CD流水线集成以及需要频繁重建数据库的场景。

我最近在开发一个需要频繁测试读写分离功能的项目，每次手动配置主从同步都要花大量时间。后来发现用Docker Compose可以把这个过程简化到不可思议的程度。下面就把这个"5分钟方案"的完整实现过程分享给大家。

2. 环境准备与工具选型

2.1 基础环境要求

• Docker 20.10.0+
• Docker Compose 2.0.0+
• 至少2GB可用内存
• Linux/macOS/WSL2环境（Windows原生Docker可能会有网络配置差异）

注意：生产环境建议使用专用服务器而非本地开发机，本文配置仅适用于开发和测试场景

2.2 MySQL镜像选择

官方mysql:8.0镜像是最稳妥的选择：

• 版本稳定，更新及时
• 默认包含主从复制所需组件
• 支持通过环境变量初始化配置

不推荐使用latest标签，明确指定8.0版本可以避免兼容性问题：

image: mysql:8.0

3. Docker Compose文件解析

3.1 完整compose.yml配置

version: '3.8'

services:
  mysql-master:
    image: mysql:8.0
    container_name: mysql-master
    environment:
      MYSQL_ROOT_PASSWORD: masterpassword
      MYSQL_DATABASE: app_db
      MYSQL_USER: replicator
      MYSQL_PASSWORD: replicapass
    volumes:
      - ./master-data:/var/lib/mysql
      - ./master-conf:/etc/mysql/conf.d
    ports:
      - "3306:3306"
    networks:
      - mysql-net
    command: 
      --server-id=1
      --log-bin=mysql-bin
      --binlog-format=ROW
      --gtid-mode=ON
      --enforce-gtid-consistency=ON

  mysql-slave:
    image: mysql:8.0 
    container_name: mysql-slave
    environment:
      MYSQL_ROOT_PASSWORD: slavepassword
    volumes:
      - ./slave-data:/var/lib/mysql
      - ./slave-conf:/etc/mysql/conf.d
    ports:
      - "3307:3306"
    networks:
      - mysql-net
    depends_on:
      - mysql-master
    command:
      --server-id=2
      --log-bin=mysql-bin
      --binlog-format=ROW
      --gtid-mode=ON
      --enforce-gtid-consistency=ON
      --skip-slave-start

networks:
  mysql-net:
    driver: bridge

3.2 关键配置说明

1. 网络配置 ：

   • 使用自定义bridge网络mysql-net
   • 容器间通过服务名直接通信

2. 数据持久化 ：

   • master-data/slave-data目录挂载数据文件
   • master-conf/slave-conf目录挂载自定义配置

3. 主库特殊参数 ：

   --server-id=1  # 必须唯一
   --log-bin=mysql-bin  # 启用二进制日志
   --gtid-mode=ON  # 使用全局事务ID
   

4. 从库特殊参数 ：

   --skip-slave-start  # 启动时不自动开始复制
   

4. 主从配置实操步骤

4.1 启动容器集群

docker-compose up -d

检查容器状态：

docker-compose ps

4.2 配置主库复制账号

进入主库容器：

docker exec -it mysql-master mysql -uroot -pmasterpassword

执行授权命令：

CREATE USER 'replicator'@'%' IDENTIFIED BY 'replicapass';
GRANT REPLICATION SLAVE ON *.* TO 'replicator'@'%';
FLUSH PRIVILEGES;

查看主库状态：

SHOW MASTER STATUS\G

记录File和Position值（示例输出）：

File: mysql-bin.000003
Position: 785

4.3 配置从库复制

进入从库容器：

docker exec -it mysql-slave mysql -uroot -pslavepassword

配置复制源：

CHANGE MASTER TO
MASTER_HOST='mysql-master',
MASTER_USER='replicator',
MASTER_PASSWORD='replicapass',
MASTER_AUTO_POSITION=1;

启动复制：

START SLAVE;

检查复制状态：

SHOW SLAVE STATUS\G

确认以下两项为Yes即表示成功：

Slave_IO_Running: Yes
Slave_SQL_Running: Yes

5. 验证与测试

5.1 基础验证

在主库创建测试数据：

USE app_db;
CREATE TABLE test(id INT PRIMARY KEY, name VARCHAR(20));
INSERT INTO test VALUES(1, 'master_data');

在从库查询：

USE app_db;
SELECT * FROM test;

5.2 延迟测试

主库执行：

INSERT INTO test VALUES(2, 'sync_test');

立即在从库查询：

SELECT * FROM test WHERE id=2;

正常情况下应该在1秒内可见数据。

6. 常见问题排查

6.1 复制中断处理

当Slave_SQL_Running变为No时，常见解决方法：

1. 跳过错误（仅限测试环境）：

STOP SLAVE;
SET GLOBAL sql_slave_skip_counter=1;
START SLAVE;

2. 重置复制（数据量小时）：

STOP SLAVE;
RESET SLAVE;
CHANGE MASTER TO ...; # 重新配置
START SLAVE;

6.2 网络连接问题

如果Slave_IO_Running为No：

1. 检查主从容器的网络连通性
2. 验证复制账号权限
3. 查看Docker网络配置

6.3 数据不一致处理

使用pt-table-checksum工具校验：

docker run --rm -it \
  --network=mysql-master_mysql-net \
  percona/percona-toolkit \
  pt-table-checksum h=mysql-master,u=root,p=masterpassword

7. 生产环境优化建议

7.1 安全加固

1. 修改默认root密码
2. 限制复制账号权限
3. 启用SSL加密连接
4. 配置适当的防火墙规则

7.2 性能调优

在my.cnf中添加：

[mysqld]
# 主库配置
sync_binlog=1
innodb_flush_log_at_trx_commit=1
binlog_group_commit_sync_delay=100
binlog_group_commit_sync_no_delay_count=10

# 从库配置 
read_only=ON
super_read_only=ON
slave_parallel_workers=4
slave_parallel_type=LOGICAL_CLOCK

7.3 监控方案

推荐配置：

1. Prometheus + mysqld_exporter
2. 监控关键指标：
   • 复制延迟(Seconds_Behind_Master)
   • IO/SQL线程状态
   • 网络流量

8. 扩展应用场景

8.1 读写分离实现

在应用层配置：

# Django示例
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'HOST': 'mysql-master',
        # ...
    },
    'replica': {
        'ENGINE': 'django.db.backends.mysql',
        'HOST': 'mysql-slave',
        # ...
    }
}

8.2 多从库配置

只需在compose.yml中添加：

mysql-slave2:
  image: mysql:8.0
  # 配置与slave1类似
  environment:
    MYSQL_ROOT_PASSWORD: slave2password
  ports:
    - "3308:3306"
  command:
    --server-id=3
    # 其他参数同slave1

8.3 备份方案集成

添加备份服务：

mysql-backup:
  image: percona/percona-xtrabackup
  volumes:
    - ./backups:/backups
  depends_on:
    - mysql-master
  command: [
    "bash", "-c",
    "xtrabackup --backup --host=mysql-master --user=root --password=masterpassword --target-dir=/backups/$(date +%Y%m%d)"
  ]

这套Docker Compose方案我已经在多个项目中实际应用，最大的优势就是重建环境的速度。当需要测试不同的数据同步场景时，只需要 docker-compose down -v && docker-compose up -d ，5分钟后就能得到一个全新的主从环境。对于需要频繁验证数据库行为的开发场景，这个效率提升是非常可观的。