projektmotor/mysql-replication

MySQL主主复制Docker镜像

镜像概述和主要用途

该Docker镜像提供简单易用的MySQL主主复制（Master-Master Replication）解决方案，通过预配置机制实现两个MySQL实例双向数据同步。每个实例既作为主库接收写入请求，又作为从库同步另一实例数据，有效提升数据库架构可用性，降低单点故障风险，适用于需要高可用和读写分离的场景。

核心功能和特性

• 简化配置：无需手动编辑MySQL配置文件和复制参数，通过环境变量即可完成主主复制配置
• 自动初始化：容器启动时自动建立复制关系，包括创建复制用户、配置二进制日志和中继日志
• 灵活定制：支持自定义root密码、复制用户及密码，可配置端口和数据存储路径
• 数据持久化：支持挂载本地目录或卷存储数据文件，确保数据不丢失
• 轻量级设计：基于官方MySQL镜像构建，保持高效运行性能和较小体积

使用场景和适用范围

• 高可用性需求：适用于需避免单点故障的中小型应用，确保数据库服务持续可用
• 读写分离架构：支持将读请求分散到两个节点，提升整体查询性能
• 开发测试环境：快速搭建主主复制环境，验证数据同步逻辑和故障转移机制
• 数据备份方案：实现双向数据同步，互为备份，降低数据丢失风险

使用方法和配置说明

基本使用（docker run）

需启动两个容器实例，分别作为主节点1和主节点2：

启动主节点1：

bash
docker run -d \
  --name mysql-master1 \
  -e MYSQL_ROOT_PASSWORD=rootpassword \
  -e REPLICATION_USER=repluser \
  -e REPLICATION_PASSWORD=replpassword \
  -e MASTER_HOST=mysql-master2 \
  -e MASTER_PORT=3306 \
  -p 3306:3306 \
  -v mysql-data1:/var/lib/mysql \
  your-image-name:tag

启动主节点2：

bash
docker run -d \
  --name mysql-master2 \
  -e MYSQL_ROOT_PASSWORD=rootpassword \
  -e REPLICATION_USER=repluser \
  -e REPLICATION_PASSWORD=replpassword \
  -e MASTER_HOST=mysql-master1 \
  -e MASTER_PORT=3306 \
  -p 3307:3306 \
  -v mysql-data2:/var/lib/mysql \
  your-image-name:tag

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  master1:
    image: your-image-name:tag
    container_name: mysql-master1
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - REPLICATION_USER=repluser
      - REPLICATION_PASSWORD=replpassword
      - MASTER_HOST=master2
      - MASTER_PORT=3306
    volumes:
      - mysql-data1:/var/lib/mysql
    restart: always

  master2:
    image: your-image-name:tag
    container_name: mysql-master2
    ports:
      - "3307:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - REPLICATION_USER=repluser
      - REPLICATION_PASSWORD=replpassword
      - MASTER_HOST=master1
      - MASTER_PORT=3306
    volumes:
      - mysql-data2:/var/lib/mysql
    restart: always

volumes:
  mysql-data1:
  mysql-data2:

启动服务：docker-compose up -d

环境变量说明

验证复制状态

进入容器检查复制状态：

bash
docker exec -it mysql-master1 mysql -uroot -p$MYSQL_ROOT_PASSWORD
mysql> SHOW SLAVE STATUS\G

当Slave_IO_Running和Slave_SQL_Running均为Yes时，复制正常。

注意事项

• 两节点server-id自动分配为不同值，无需手动配置
• 确保容器间网络互通（推荐使用Docker Compose或同一网络）
• 生产环境建议配置定期数据备份策略
• 高并发写入可能导致复制延迟，需根据业务评估适用性