Docker部署MySQL：从基础到主从复制实战

1. 为什么选择Docker部署MySQL？

在传统开发环境中，安装MySQL通常需要下载安装包、配置环境变量、手动修改my.cnf文件等一系列繁琐操作。而使用Docker容器化部署，就像把整个MySQL服务器打包成一个便携式"应用程序"，只需一条命令就能完成安装和配置。

我最近在帮团队迁移开发环境时，用Docker在10分钟内就搭建好了包含主从复制的MySQL集群。相比之前手动安装半小时还经常遇到版本冲突，这种效率提升让人印象深刻。Docker部署MySQL主要有以下优势：

• 环境隔离：每个容器都是独立的沙箱，不会污染主机环境。比如可以同时运行MySQL 5.7和8.0版本进行兼容性测试
• 快速部署：官方镜像已优化配置，docker run命令即可启动生产级MySQL实例
• 资源可控：通过cgroups限制CPU/内存使用，避免数据库拖垮宿主机
• 数据持久化：通过volume机制，容器销毁后数据依然保留
• 版本管理：随时切换不同MySQL版本，无需重装系统

提示：虽然Docker简化了部署，但生产环境仍需谨慎。建议至少配置数据卷、网络隔离和资源限制三大基础防护措施。

2. 安装前的环境准备

2.1 系统需求检查

在开始之前，需要确认宿主机满足以下条件：

1. 操作系统：主流Linux发行版（Ubuntu/CentOS等）、macOS 10.15+或Windows 10/11（需WSL2支持）
2. Docker版本：建议使用Docker 20.10.0+，可通过docker --version验证
3. 硬件资源：
   • 至少2GB空闲内存（MySQL默认会占用512MB）
   • 10GB可用磁盘空间（数据文件+日志）
4. 虚拟化支持：
   • Linux内核需4.x以上版本
   • Windows/Mac需开启VT-x/AMD-V虚拟化

常见问题排查：

bash复制# 检查虚拟化支持（Linux）
grep -E --color 'vmx|svm' /proc/cpuinfo

# Windows用户若遇到"Virtualization not enabled"错误
# 需进入BIOS开启Intel VT-x或AMD-V选项

2.2 Docker安装与配置

对于尚未安装Docker的环境，以下是各平台快速安装指南：

Ubuntu/Debian：

bash复制# 卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc

# 设置仓库
sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# 添加GPG密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 设置稳定版仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker引擎
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 验证安装
sudo docker run hello-world

Windows/Mac：

1. 下载Docker Desktop安装包：
   • Windows：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe
   • Mac（Intel芯片）：https://desktop.docker.com/mac/main/amd64/Docker.dmg
   • Mac（M1芯片）：https://desktop.docker.com/mac/main/arm64/Docker.dmg
2. 双击安装后，在系统托盘图标右键选择"Start Docker"

注意：国内用户建议配置镜像加速器，在/etc/docker/daemon.json中添加：

json复制{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}

然后执行sudo systemctl restart docker

3. MySQL容器化部署实战

3.1 单实例基础部署

最简启动命令如下：

bash复制docker run --name some-mysql \
  -e MYSQL_ROOT_PASSWORD=my-secret-pw \
  -d mysql:8.0

这个命令做了三件事：

1. 从Docker Hub拉取mysql:8.0镜像
2. 创建名为some-mysql的容器
3. 设置root密码为my-secret-pw

但生产环境需要更完善的配置：

bash复制docker run --name=mysql8 \
  -e MYSQL_ROOT_PASSWORD=ComplexPwd@123 \
  -e MYSQL_DATABASE=app_db \
  -e MYSQL_USER=app_user \
  -e MYSQL_PASSWORD=UserPwd@456 \
  -p 3306:3306 \
  -v /data/mysql/conf:/etc/mysql/conf.d \
  -v /data/mysql/data:/var/lib/mysql \
  --restart=unless-stopped \
  --memory=2g \
  --cpus=2 \
  -d mysql:8.0 \
  --character-set-server=utf8mb4 \
  --collation-server=utf8mb4_unicode_ci

参数解析：

• -v /data/mysql/conf:/etc/mysql/conf.d：挂载自定义配置文件目录
• -v /data/mysql/data:/var/lib/mysql：数据持久化存储
• --memory=2g --cpus=2：限制资源使用
• 末尾参数：设置默认字符集为utf8mb4

3.2 配置文件定制

在挂载的conf目录下创建custom.cnf：

ini复制[mysqld]
max_connections=500
innodb_buffer_pool_size=1G
slow_query_log=1
long_query_time=2
log_error_verbosity=3

[client]
default-character-set=utf8mb4

重启容器使配置生效：

bash复制docker restart mysql8

3.3 多版本管理技巧

Docker可以轻松管理多个MySQL版本：

bash复制# 启动MySQL 5.7实例
docker run --name=mysql57 \
  -e MYSQL_ROOT_PASSWORD=root_pwd \
  -p 3307:3306 \
  -d mysql:5.7

# 启动MySQL 8.0实例 
docker run --name=mysql80 \
  -e MYSQL_ROOT_PASSWORD=root_pwd \
  -p 3308:3306 \
  -d mysql:8.0

通过不同端口映射，可以在同一台机器上同时运行多个版本的MySQL服务。

4. 高级部署方案

4.1 主从复制配置

使用Docker Compose搭建一主一从架构：

docker-compose.yml：

yaml复制version: '3'
services:
  mysql-master:
    image: mysql:8.0
    container_name: mysql-master
    environment:
      MYSQL_ROOT_PASSWORD: master_root_pwd
      MYSQL_REPLICATION_USER: repl_user
      MYSQL_REPLICATION_PASSWORD: repl_pwd
    volumes:
      - ./master/conf:/etc/mysql/conf.d
      - ./master/data:/var/lib/mysql
    ports:
      - "3306:3306"
    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: slave_root_pwd
    volumes:
      - ./slave/conf:/etc/mysql/conf.d
      - ./slave/data:/var/lib/mysql
    ports:
      - "3307:3306"
    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

配置主从同步：

bash复制# 在主库创建复制账号
docker exec -it mysql-master mysql -uroot -p
CREATE USER 'repl_user'@'%' IDENTIFIED BY 'repl_pwd';
GRANT REPLICATION SLAVE ON *.* TO 'repl_user'@'%';

# 查看主库状态
SHOW MASTER STATUS;

# 在从库配置复制
docker exec -it mysql-slave mysql -uroot -p
CHANGE MASTER TO
  MASTER_HOST='mysql-master',
  MASTER_USER='repl_user',
  MASTER_PASSWORD='repl_pwd',
  MASTER_AUTO_POSITION=1;
START SLAVE;

# 验证复制状态
SHOW SLAVE STATUS\G

4.2 数据库备份策略

推荐三种备份方案：

1. 使用mysqldump自动备份

bash复制# 创建备份脚本
cat > /backup/mysql_backup.sh <<EOF
#!/bin/bash
docker exec mysql8 sh -c 'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' > /backup/full-$(date +%F).sql
EOF

# 添加定时任务（每天凌晨2点执行）
(crontab -l ; echo "0 2 * * * /bin/bash /backup/mysql_backup.sh") | crontab -

2. 直接备份数据卷

bash复制# 暂停MySQL服务
docker stop mysql8

# 打包数据目录
tar -czvf mysql-data-$(date +%F).tar.gz /data/mysql/data

# 恢复时解压到原目录
docker start mysql8

3. 使用Percona XtraBackup

bash复制docker run -it --rm \
  -v /data/mysql/data:/var/lib/mysql \
  -v /backup:/backup \
  percona/percona-xtrabackup \
  xtrabackup --backup --target-dir=/backup/full-$(date +%F) \
  --user=root --password=ComplexPwd@123

5. 常见问题排查

5.1 性能优化建议

通过docker stats监控资源使用：

bash复制docker stats mysql8

如果发现性能瓶颈，可以调整以下参数：

修改方式：

bash复制# 临时调整（立即生效）
docker exec -it mysql8 mysql -uroot -p
SET GLOBAL innodb_buffer_pool_size=1073741824;  # 1GB

# 永久生效需修改my.cnf并重启容器

5.2 连接问题排查

错误：Client does not support authentication protocol

MySQL 8.0默认使用caching_sha2_password插件，旧客户端可能不支持：

sql复制-- 解决方案1：修改用户密码插件
ALTER USER 'app_user'@'%' IDENTIFIED WITH mysql_native_password BY 'UserPwd@456';

-- 解决方案2：全局修改默认认证方式（需重启）
[mysqld]
default_authentication_plugin=mysql_native_password

错误：Too many connections

检查连接数：

sql复制SHOW STATUS LIKE 'Threads_connected';
SHOW VARIABLES LIKE 'max_connections';

临时增加连接数：

sql复制SET GLOBAL max_connections=500;

5.3 数据恢复操作

从SQL备份文件恢复：

bash复制cat backup.sql | docker exec -i mysql8 mysql -uroot -pComplexPwd@123

从物理备份恢复：

bash复制# 停止容器
docker stop mysql8

# 替换数据目录
rm -rf /data/mysql/data/*
tar -xzvf backup.tar.gz -C /data/mysql/data

# 重启容器
docker start mysql8

6. 生产环境最佳实践

6.1 安全加固措施

1. 修改默认端口：

   bash复制docker run -p 33060:3306 ...
   

2. 禁用远程root登录：

   sql复制CREATE USER 'admin'@'%' IDENTIFIED BY 'StrongPwd!';
   GRANT ALL PRIVILEGES ON *.* TO 'admin'@'%';
   REVOKE ALL PRIVILEGES ON *.* FROM 'root'@'%';
   

3. 启用SSL连接：

   bash复制# 生成证书（宿主机操作）
   openssl req -x509 -newkey rsa:4096 -keyout server-key.pem -out server-cert.pem -days 365 -nodes
   
   # 启动容器时挂载证书
   docker run -v /path/to/certs:/etc/mysql/certs ...
   
   # MySQL配置
   [mysqld]
   ssl-ca=/etc/mysql/certs/server-cert.pem
   ssl-cert=/etc/mysql/certs/server-cert.pem
   ssl-key=/etc/mysql/certs/server-key.pem
   

6.2 监控方案集成

使用Prometheus监控MySQL：

1. 启动带metrics的MySQL容器：

   bash复制docker run -e MYSQL_ROOT_PASSWORD=root_pwd \
     -e MYSQL_EXPORTER_PASSWORD=exporter_pwd \
     -p 9104:9104 \
     -d prom/mysqld-exporter
   

2. Prometheus配置示例：

   yaml复制scrape_configs:
     - job_name: 'mysql'
       static_configs:
         - targets: ['mysql-host:9104']
   

3. Grafana仪表盘导入ID：7362

6.3 自动化运维技巧

使用Shell脚本自动管理：

bash复制#!/bin/bash
# 自动备份并清理旧备份
BACKUP_DIR=/backup/mysql
DATE=$(date +%F)

docker exec mysql8 mysqldump -uroot -pComplexPwd@123 --all-databases > $BACKUP_DIR/full-$DATE.sql
find $BACKUP_DIR -type f -mtime +7 -exec rm {} \;

Docker健康检查配置：

yaml复制healthcheck:
  test: ["CMD-SHELL", "mysqladmin ping -h localhost -uroot -p$$MYSQL_ROOT_PASSWORD --silent"]
  interval: 10s
  timeout: 5s
  retries: 3