Docker Compose 配置 MySQL 的核心是编写 docker-compose.yml,需指定镜像、端口映射(如3306:3306)、MYSQL_ROOT_PASSWORD 环境变量、数据卷挂载(mysql-data:/var/lib/mysql)及可选的初始化SQL和自定义my.cnf配置。

在 Docker Compose 中配置 MySQL,核心是编写一个 docker-compose.yml 文件,定义 MySQL 服务的镜像、端口、环境变量(尤其是 root 密码)、数据卷挂载和网络设置。配置不当容易导致容器启动失败、数据丢失或无法远程连接。
基础 MySQL 服务配置
这是最简可用的配置,适用于开发测试:
- 使用官方
mysql:8.0或mysql:5.7镜像(推荐 8.0,注意客户端兼容性) - 通过
MYSQL_ROOT_PASSWORD必须设置 root 密码,否则容器会启动失败 - 映射宿主机端口(如
3306:3306),方便本地用客户端连接 - 挂载数据卷(
mysql-data:/var/lib/mysql)确保容器重启后数据不丢失
示例 docker-compose.yml:
version: '3.8'
services:
mysql:
image: mysql:8.0
container_name: my-mysql
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: my-secret-pw
ports:
- "3306:3306"
volumes:
- mysql-data:/var/lib/mysql
volumes:
mysql-data:
添加初始化 SQL 脚本
希望容器首次启动时自动创建数据库、用户或导入表结构,可将 .sql 或 .sql.gz 文件挂载到 /docker-entrypoint-initdb.d/ 目录:
- 文件需放在宿主机目录(如
./init/),并在 compose 中挂载 - MySQL 启动时会按字母顺序执行该目录下所有
.sql文件 - 仅在首次初始化空数据目录时生效,后续重启不会重复执行
追加配置示例:
volumes: - mysql-data:/var/lib/mysql - ./init/:/docker-entrypoint-initdb.d/
例如 ./init/01-create-db.sql 内容可为:CREATE DATABASE IF NOT EXISTS app_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
自定义 MySQL 配置(my.cnf)
如需调整最大连接数、时区、字符集等,可通过挂载自定义配置文件实现:
- 准备
my.cnf(放在项目根目录或./conf/下) - 挂载到容器内
/etc/mysql/conf.d/(MySQL 8.0 默认读取此目录下的.cnf文件) - 避免覆盖默认配置,建议只写需要修改的项,例如:
[mysqld] default-time-zone = '+08:00' max_connections = 200 character-set-server = utf8mb4 collation-server = utf8mb4_unicode_ci
对应挂载写法:
volumes: - ./conf/my.cnf:/etc/mysql/conf.d/custom.cnf
连接与验证要点
配置完成后,启动并验证是否正常工作:
- 运行
docker-compose up -d启动服务 - 检查日志:
docker-compose logs -f mysql,确认无ERROR且出现MySQL init process done. Ready for start up. - 本地连接测试:
mysql -h 127.0.0.1 -P 3306 -u root -p,输入密码即可登录 - 若应用容器需连接 MySQL,确保它们在同一个 Docker 网络(默认 compose 自动创建),直接用服务名
mysql作 host(如jdbc:mysql://mysql:3306/app_db)










