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

1. 项目概述MySQL主从复制是数据库高可用架构的基础配置传统手工部署至少需要半天时间配置和调试。而使用Docker Compose我们可以在5分钟内完成一套完整的主从集群搭建。这种方案特别适合开发测试环境快速搭建、CI/CD流水线集成以及需要频繁重建数据库的场景。我最近在开发一个需要频繁测试读写分离功能的项目每次手动配置主从同步都要花大量时间。后来发现用Docker Compose可以把这个过程简化到不可思议的程度。下面就把这个5分钟方案的完整实现过程分享给大家。2. 环境准备与工具选型2.1 基础环境要求Docker 20.10.0Docker Compose 2.0.0至少2GB可用内存Linux/macOS/WSL2环境Windows原生Docker可能会有网络配置差异注意生产环境建议使用专用服务器而非本地开发机本文配置仅适用于开发和测试场景2.2 MySQL镜像选择官方mysql:8.0镜像是最稳妥的选择版本稳定更新及时默认包含主从复制所需组件支持通过环境变量初始化配置不推荐使用latest标签明确指定8.0版本可以避免兼容性问题image: mysql:8.03. 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-id1 --log-binmysql-bin --binlog-formatROW --gtid-modeON --enforce-gtid-consistencyON 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-id2 --log-binmysql-bin --binlog-formatROW --gtid-modeON --enforce-gtid-consistencyON --skip-slave-start networks: mysql-net: driver: bridge3.2 关键配置说明网络配置使用自定义bridge网络mysql-net容器间通过服务名直接通信数据持久化master-data/slave-data目录挂载数据文件master-conf/slave-conf目录挂载自定义配置主库特殊参数--server-id1 # 必须唯一 --log-binmysql-bin # 启用二进制日志 --gtid-modeON # 使用全局事务ID从库特殊参数--skip-slave-start # 启动时不自动开始复制4. 主从配置实操步骤4.1 启动容器集群docker-compose up -d检查容器状态docker-compose ps4.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: 7854.3 配置从库复制进入从库容器docker exec -it mysql-slave mysql -uroot -pslavepassword配置复制源CHANGE MASTER TO MASTER_HOSTmysql-master, MASTER_USERreplicator, MASTER_PASSWORDreplicapass, MASTER_AUTO_POSITION1;启动复制START SLAVE;检查复制状态SHOW SLAVE STATUS\G确认以下两项为Yes即表示成功Slave_IO_Running: Yes Slave_SQL_Running: Yes5. 验证与测试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 id2;正常情况下应该在1秒内可见数据。6. 常见问题排查6.1 复制中断处理当Slave_SQL_Running变为No时常见解决方法跳过错误仅限测试环境STOP SLAVE; SET GLOBAL sql_slave_skip_counter1; START SLAVE;重置复制数据量小时STOP SLAVE; RESET SLAVE; CHANGE MASTER TO ...; # 重新配置 START SLAVE;6.2 网络连接问题如果Slave_IO_Running为No检查主从容器的网络连通性验证复制账号权限查看Docker网络配置6.3 数据不一致处理使用pt-table-checksum工具校验docker run --rm -it \ --networkmysql-master_mysql-net \ percona/percona-toolkit \ pt-table-checksum hmysql-master,uroot,pmasterpassword7. 生产环境优化建议7.1 安全加固修改默认root密码限制复制账号权限启用SSL加密连接配置适当的防火墙规则7.2 性能调优在my.cnf中添加[mysqld] # 主库配置 sync_binlog1 innodb_flush_log_at_trx_commit1 binlog_group_commit_sync_delay100 binlog_group_commit_sync_no_delay_count10 # 从库配置 read_onlyON super_read_onlyON slave_parallel_workers4 slave_parallel_typeLOGICAL_CLOCK7.3 监控方案推荐配置Prometheus mysqld_exporter监控关键指标复制延迟(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-id3 # 其他参数同slave18.3 备份方案集成添加备份服务mysql-backup: image: percona/percona-xtrabackup volumes: - ./backups:/backups depends_on: - mysql-master command: [ bash, -c, xtrabackup --backup --hostmysql-master --userroot --passwordmasterpassword --target-dir/backups/$(date %Y%m%d) ]这套Docker Compose方案我已经在多个项目中实际应用最大的优势就是重建环境的速度。当需要测试不同的数据同步场景时只需要docker-compose down -v docker-compose up -d5分钟后就能得到一个全新的主从环境。对于需要频繁验证数据库行为的开发场景这个效率提升是非常可观的。