news 2026/7/26 1:57:08

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
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分钟后就能得到一个全新的主从环境。对于需要频繁验证数据库行为的开发场景，这个效率提升是非常可观的。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/7/26 1:55:18

跨模态VLA模型：视觉语言动作迁移技术解析

1. 跨模态智能体迁移的技术突破去年在机器人实验室调试机械臂时，我发现一个有趣现象：当操作员口头描述"把红色方块放到蓝色盒子左侧"时，经过多模态训练的机器人竟能准确执行指令，而传统编程方式完成同样任务需要编写数十…

作者头像 李华
网站建设 2026/7/26 1:48:45

LeagueAkari终极指南：英雄联盟玩家的智能游戏助手

LeagueAkari终极指南：英雄联盟玩家的智能游戏助手 【免费下载链接】League-Toolkit An all-in-one toolkit for LeagueClient. Gathering power 🚀. 项目地址: https://gitcode.com/gh_mirrors/le/League-Toolkit LeagueAkari是一款基于英雄联盟L…

作者头像 李华
网站建设 2026/7/26 1:47:41

LoRA微调技术：高效定制大语言模型的实践指南

1. 为什么你需要掌握LoRA微调技术上周帮朋友公司调试大语言模型时遇到个典型场景：他们想用GPT-3.5接口实现智能客服，但直接调用原版API总出现行业术语理解偏差。当我用LoRA微调了不到100条对话样本后，响应准确率直接从62%飙升至89%——这就是…

作者头像 李华
网站建设 2026/7/26 1:45:18

开源世界模型：架构解析与工程实践

1. 开源世界模型的前沿探索当我在2019年第一次尝试将Transformer架构应用于环境建模时，服务器连续崩溃了7次。这种挫败感恰恰反映了构建世界模型的本质挑战——我们需要教会机器像人类一样理解物理世界的运作规律。开源世界模型作为当前AI领域最具潜力的方向之一&am…

作者头像 李华
网站建设 2026/7/26 1:43:50

TI MSP430AFE253单相电能计量参考设计深度解析与实战指南

1. 项目概述与核心价值在嵌入式系统开发，尤其是工业控制和能源管理领域，电能计量是一个既基础又充满挑战的课题。它不仅仅是简单地测量电压和电流，更关乎如何从嘈杂的工频信号中，精准地提取出有功功率、无功功率、功率因数等关键参…

作者头像 李华