当前位置：首页 > news >正文

10、Docker Compose 安装 MySQL

news 2025/7/30 16:13:02

🐳 使用 Docker Compose 安装 MySQL（含配置详解与常见问题）

标签：#DockerCompose #MySQL #数据库部署 #后端开发 #运维入门 #配置详解
适合读者：开发者、DevOps、新手运维人员

📌 一、前言

在日常开发与部署中，我们经常需要快速搭建一个独立的 MySQL 实例。相比手动安装，使用 Docker Compose 能以最小成本完成部署、启动、关闭、迁移等一整套操作。

🧱 二、目录结构

docker-mysql/
├── docker-compose.yml
└── my.cnf             # 可选：自定义配置文件

⚙️ 三、docker-compose.yml 配置详解

version: "3.9"services:mysql:image: mysql:8.0container_name: mysql8restart: alwaysports:- "3306:3306"environment:MYSQL_ROOT_PASSWORD: root123456       # ✅ root用户密码（必填）MYSQL_DATABASE: demo_db               # ✅ 自动创建数据库MYSQL_USER: dev_user                  # ✅ 创建新用户MYSQL_PASSWORD: dev_pass              # ✅ 用户密码volumes:- ./data:/var/lib/mysql               # ✅ 数据持久化路径- ./my.cnf:/etc/mysql/conf.d/my.cnf   # ✅ 可选：自定义配置networks:- mysql_netnetworks:mysql_net:driver: bridge

🔍 参数详解：

配置项	含义
`image`	使用官方的 `mysql:8.0` 镜像
`container_name`	容器名称
`restart: always`	容器异常退出后自动重启
`ports`	主机:容器端口映射，默认 MySQL 为 3306
`environment`	配置 MySQL 初始参数（环境变量）
`volumes`	挂载数据和配置，确保持久化
`networks`	自定义网络，支持多服务联通

🧾 四、my.cnf 自定义配置（可选）

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
sql_mode=STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION

将其保存为 my.cnf 文件后自动生效，常用于统一字符集、SQL严格模式等。

🚀 五、启动与使用

1️⃣ 启动容器

docker compose up -d

-d 表示后台运行

2️⃣ 查看运行状态

docker ps

3️⃣ 登录 MySQL

docker exec -it mysql8 mysql -uroot -p

输入 root123456 进入

在这里插入图片描述

🧪 六、连接测试（使用客户端）

在 Navicat 或 DBeaver 中添加新连接：

主机地址：虚拟机ip
端口：3306
用户名：dev_user
密码：dev_pass
数据库：demo_db

在这里插入图片描述

❗ 七、常见问题处理

问题	解决方式
容器启动报错 `Can't connect to local MySQL server`	检查端口是否被占用，或数据目录权限问题
`Access denied for user`	检查环境变量用户名/密码是否一致
字符集乱码	使用 `my.cnf` 配置为 `utf8mb4`
Docker 数据未持久化	确认 `./data` 已正确挂载

🛠 八、最佳实践建议

✅ 使用 volumes 绑定宿主机数据，避免数据丢失
✅ 启用 mysql.cnf 进行统一配置管理
✅ 推荐使用非 root 用户连接数据库
✅ 配合 phpMyAdmin 或其他服务通过 Compose 一键启动集群

📦 九、扩展：一键添加 phpMyAdmin（可选）

  phpmyadmin:image: phpmyadmin/phpmyadminrestart: alwaysports:- "8080:80"environment:PMA_HOST: mysql8depends_on:- mysqlnetworks:- mysql_net

🔍 参数详解：

配置项	含义
`phpmyadmin`	官方 `phpMyAdmin` 镜像
`ports: "8080:80"`	主机8080端口映射到容器80端口
`PMA_HOST: mysql8`	phpMyAdmin 连接数据库主机名，应该与 mysql 服务名一致
`depends_on: mysql`	启动顺序控制，先启动 MySQL
`networks: mysql_net`	需要保证和mysql在同一网络