5分钟用Docker Compose搭建MySQL主从复制集群

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;
  1. 重置复制（数据量小时）：
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分钟后就能得到一个全新的主从环境。对于需要频繁验证数据库行为的开发场景，这个效率提升是非常可观的。