Docker 环境下 MySQL 一主一从同步实战

Docker 环境下 MySQL 一主一从同步实战前言在实际开发与生产场景中MySQL 单节点往往无法满足高可用、高并发以及数据备份的需求。主从复制作为 MySQL 最经典的高可用方案能够实现读写分离、故障转移与数据冗余备份。本文将基于 Docker 容器化环境使用 MySQL 8.3.0 版本快速搭建一主一从架构全程通过自动化 Shell 脚本实现部署无需手动修改复杂配置文件可复现、易维护非常适合学习与测试环境使用。一、环境说明操作系统Windows WSL2容器引擎DockerMySQL 版本8.3.0主库端口3307从库端口3308root 密码123456复制账号repl / 123456二、主从复制原理简述主库Master开启二进制日志binlog所有数据变更都会记录到 binlog 中。为 IO 线程提供 binlog 读取权限。从库SlaveIO 线程连接主库请求并接收 binlog写入中继日志relay log。SQL 线程读取中继日志重放 SQL 语句实现数据同步。三、一键部署脚本为了简化部署流程避免手动配置出错编写自动化 Shell 脚本mysql_ms_deploy.sh。bash运行#!/bin/bash # MySQL 8.3.0 主从一键脚本 # 主库3307 从库3308 密码123456 # echo echo MySQL 8.3.0 Master-Slave Deploy echo Master: 3307 | Slave: 3308 echo Password: 123456 echo # 1. 清理旧容器 echo -e \n[1/6] 清理旧容器... docker rm -f mysql-master mysql-slave /dev/null 21 # 2. 启动主库 echo -e \n[2/6] 启动主库3307... docker run -d --name mysql-master \ -p 3307:3306 \ -e MYSQL_ROOT_PASSWORD123456 \ mysql:8.3.0 \ --server-id1 \ --log-binmysql-bin \ --binlog-formatROW # 3. 启动从库 echo -e \n[3/6] 启动从库3308... docker run -d --name mysql-slave \ -p 3308:3306 \ -e MYSQL_ROOT_PASSWORD123456 \ mysql:8.3.0 \ --server-id2 \ --relay-logrelay-bin # 4. 等待MySQL启动 echo -e \n[4/6] 等待MySQL启动 15秒... sleep 15 # 5. 创建同步账号 echo -e \n[5/6] 创建同步账号 repl... docker exec mysql-master mysql -uroot -p123456 -e CREATE USER repl% IDENTIFIED WITH mysql_native_password BY 123456; GRANT REPLICATION SLAVE ON *.* TO repl%; FLUSH PRIVILEGES; 2/dev/null # 6. 获取主库信息并配置从库 echo -e \n[6/6] 配置主从同步... file$(docker exec mysql-master mysql -uroot -p123456 -N -e SHOW MASTER STATUS; 2/dev/null | awk {print $1}) pos$(docker exec mysql-master mysql -uroot -p123456 -N -e SHOW MASTER STATUS; 2/dev/null | awk {print $2}) master_ip$(docker inspect -f {{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}} mysql-master) docker exec mysql-slave mysql -uroot -p123456 -e STOP SLAVE; RESET SLAVE ALL; CHANGE MASTER TO MASTER_HOST$master_ip, MASTER_USERrepl, MASTER_PASSWORD123456, MASTER_LOG_FILE$file, MASTER_LOG_POS$pos; START SLAVE; 2/dev/null # 输出结果 echo -e \n echo ✅ 部署完成 echo 主库localhost:3307 root / 123456 echo 从库localhost:3308 root / 123456 echo -e \n echo 从库同步状态 docker exec mysql-slave mysql -uroot -p123456 -e SHOW SLAVE STATUS\G 2/dev/null | grep Slave_IO_Running\|Slave_SQL_Running echo -e \n 部署成功四、脚本执行步骤赋予脚本执行权限bash运行chmod x mysql_ms_deploy.sh运行脚本bash运行./mysql_ms_deploy.sh等待执行完成出现以下结果表示主从同步正常plaintextSlave_IO_Running: Yes Slave_SQL_Running: Yes五、主从同步测试主库写入数据bash运行docker exec mysql-master mysql -uroot -p123456 -e CREATE DATABASE testdb; USE testdb; CREATE TABLE user(id INT); INSERT INTO user VALUES(1);从库查询验证bash运行docker exec mysql-slave mysql -uroot -p123456 -e SELECT * FROM testdb.user;若能正常查询到数据说明主从复制搭建成功。六、常见问题与排错Slave_IO_Running: Connecting主从网络不通复制账号密码错误主库 binlog 未正常开启Slave_SQL_Running: No主从数据不一致从库执行 SQL 报错跳过事务可临时修复SET GLOBAL SQL_SLAVE_SKIP_COUNTER 1;Docker 镜像拉取失败更换镜像加速源执行docker system prune -a清理缓存项目配置演示七、总结通过 Docker 可以快速、干净地部署 MySQL 主从架构避免了传统安装方式的环境污染与复杂配置。本文提供的一键脚本自动完成容器创建与端口映射server-id、binlog、relay-log 配置复制账号创建从库自动指向主库状态自动检查整套方案可直接用于学习、测试与演示也可在此基础上扩展为 MGR、半同步复制、读写分离等更高级架构。