前言：本文将指导你如何使用 Docker Compose 轻松部署 MySQL，并加载自定义配置文件，以实现数据持久化和灵活的配置管理。在开始之前，请确保你的系统已安装 Docker 和 Docker Compose。如果你尚未安装，可以参考我的: 往期博客。

1. 创建挂载目录

首先，我们需要创建两个目录用于挂载 MySQL 的数据和配置文件，确保数据的持久化和配置的自定义。

# 创建用于存放 MySQL 数据的目录
mkdir -p /data/mysql/data

# 创建用于存放 MySQL 配置文件的目录
mkdir -p /data/mysql/conf

• /data/mysql/data: 该目录将挂载到 MySQL 容器的 /var/lib/mysql 目录，用于持久化存储 MySQL 的数据库文件。
• /data/mysql/conf: 该目录将用于存放自定义的 my.cnf 配置文件，并通过数据卷挂载到容器中，覆盖默认配置。

2. 配置 docker-compose.yml 文件

接下来，在 /data/mysql 目录下创建一个 docker-compose.yml 文件，并粘贴以下配置信息：

version: '3'
services:
  mysql:
    image: mysql:8.0.33 # 使用 MySQL 8.0.33 镜像
    container_name: mysql # 定义容器名称为 mysql
    volumes:
      - /data/mysql/data:/var/lib/mysql # 挂载数据目录
      - /data/mysql/conf/my.cnf:/etc/mysql/mysql.conf.d/mysqld.cnf # 挂载自定义配置文件
    restart: always # 容器总是尝试重新启动
    ports:
      - 3336:3306 # 将宿主机的 3336 端口映射到容器的 3306 端口
    environment:
      MYSQL_ROOT_PASSWORD: 12345678 # 设置 root 用户的密码
      TZ: Asia/Shanghai # 设置容器的时区为上海
    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci # 设置 MySQL 服务的默认字符集和排序规则

• image: mysql:8.0.33: 指定了要使用的 Docker 镜像为 MySQL，版本为 8.0.33。你可以根据需要选择其他版本。

• container_name: mysql: 为运行的 MySQL 容器指定一个名称，方便后续使用 Docker 命令进行管理。

• volumes: 定义了数据卷的挂载。

  • /data/mysql/data:/var/lib/mysql: 将宿主机上的 /data/mysql/data 目录挂载到容器内的 /var/lib/mysql 目录，用于持久化存储 MySQL 的数据。
  • /data/mysql/conf/my.cnf:/etc/mysql/mysql.conf.d/mysqld.cnf: 将宿主机上的/data/mysql/conf/my.cnf文件挂载到容器内的指定路径，用于覆盖 MySQL 的默认配置。

• restart: always: 配置 Docker 在容器意外停止时自动重新启动。

• ports: - 3336:3306: 将宿主机的 3336 端口映射到容器内部 MySQL 服务的默认端口 3306。你可以根据需要修改宿主机端口，但请注意不要与其他服务冲突。

• environment: 设置容器的环境变量。

  • MYSQL_ROOT_PASSWORD: 12345678: 设置 MySQL root 用户的初始密码。请务必修改为你自己的安全密码。
  • TZ: Asia/Shanghai: 设置容器的时区为亚洲/上海，避免时区问题。

• command: 覆盖容器启动时执行的默认命令，这里用于设置 MySQL 服务的默认字符集为 utf8mb4 和排序规则为 utf8mb4_unicode_ci，以支持更广泛的字符。

3. 创建 Mysql 配置文件

在 /data/mysql/conf 目录下创建一个名为 my.cnf 的配置文件，并粘贴以下内容：

[mysqld]
default-storage-engine=INNODB  # 创建新表时将使用的默认存储引擎
character-set-server=utf8mb4      # 设置 mysql 服务端默认字符集
pid-file        = /var/run/mysqld/mysqld.pid  # pid 文件所在目录
socket          = /var/run/mysqld/mysqld.sock # 用于本地连接的 socket 套接字
datadir         = /var/lib/mysql              # 数据文件存放的目录
symbolic-links=0
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION # 定义 mysql 应该支持的 sql 语法，数据校验等!

# 允许最大连接数
max_connections=200


# 同一局域网内注意要唯一
server-id=3336
# 开启二进制日志功能 & 日志位置存放位置`/var/lib/mysql`
#log-bin=mysql-bin
log-bin=/var/lib/mysql/mysql-bin
# binlog 格式
# 1. STATEMENT：基于 SQL 语句的模式，binlog 数据量小，但是某些语句和函数在复制过程可能导致数据不一致甚至出错；
# 2. MIXED：混合模式，根据语句来选用是 STATEMENT 还是 ROW 模式；
# 3. ROW：基于行的模式，记录的是行的完整变化。安全，但 binlog 会比其他两种模式大很多；
binlog_format=ROW
# FULL：binlog 记录每一行的完整变更 MINIMAL：只记录影响后的行
binlog_row_image=FULL
# 日志文件大小
max_binlog_size=100M
# 定义清除过期日志的时间(这里设置为 7 天)
expire_logs_days=7

# ================= ↑↑↑ mysql 主从同步配置 end ↑↑↑ =================

[mysql]
default-character-set=utf8mb4

[client]
default-character-set=utf8mb4  # 设置 mysql 客户端默认字符集

• [mysqld]: 该部分配置了 MySQL 服务端的参数。

  • default-storage-engine=INNODB: 设置默认的存储引擎为 InnoDB，它支持事务和行级锁定，是推荐的存储引擎。
  • character-set-server=utf8mb4: 设置服务端使用的默认字符集为 utf8mb4，支持存储更广泛的 Unicode 字符。
  • datadir=/var/lib/mysql: 指定 MySQL 数据文件存放的目录，与 docker-compose.yml 中挂载的数据卷对应。
  • sql_mode: 定义了 MySQL 应该支持的 SQL 语法和数据校验规则。这里设置了严格模式。
  • max_connections: 设置允许的最大客户端连接数。
  • server-id: 在主从复制环境中用于唯一标识服务器。在单机部署中，保持唯一即可。
  • log-bin: 启用二进制日志，用于数据恢复和主从复制。这里指定了日志文件的路径。
  • binlog_format=ROW: 设置二进制日志的格式为 ROW，记录每一行的更改，更安全可靠。
  • binlog_row_image=FULL: 记录完整的行变更信息。
  • max_binlog_size: 设置单个二进制日志文件的最大大小。
  • expire_logs_days: 设置二进制日志的过期天数，MySQL 会自动清理过期的日志。

• [mysql]: 该部分配置了 MySQL 客户端的默认字符集。

• [client]: 该部分配置了 MySQL 命令行客户端的默认字符集。

4. 启动 MySQL 容器

完成以上配置后，切换到 /data/mysql 目录，并使用 Docker Compose 启动 MySQL 容器：

cd /data/mysql
docker-compose up -d

如果镜像未拉取，执行该命令会自动去拉取对应的镜像

5. 后续操作

容器启动后，你可以使用以下命令查看容器的运行状态：

docker ps

你应该能看到名为 mysql 的容器正在运行，并且宿主机的 3336 端口已经映射到容器的 3306 端口。

重要提示：

• 云服务器： 如果你使用的是云服务器，请务必在服务器的安全组或防火墙设置中开放 TCP 协议的 3336 端口（你在 docker-compose.yml 中配置的宿主机端口），否则外部无法连接到 MySQL 服务。
• 本地服务器： 如果你在本地服务器上运行，也需要检查并允许防火墙通过 TCP 协议的 3336 端口。例如，在使用 ufw 的 Linux 系统上，可以使用 sudo ufw allow 3336/tcp 命令。

接下来，你可以使用任何 MySQL 客户端工具（例如 Navicat、DBeaver、MySQL Workbench 等）通过 你的服务器IP地址:3336 连接到 MySQL 数据库。默认的 root 用户密码是你在 docker-compose.yml 中设置的 12345678 。

总结

通过本文的步骤，你已经成功地使用 Docker Compose 部署了 MySQL 8.0.33，并实现了数据的持久化和自定义配置。Docker Compose 通过简单的 YAML 文件，极大地简化了多容器应用的部署和管理流程。你可以根据实际应用场景的需求，进一步调整 docker-compose.yml 和 my.cnf 文件，以满足更复杂的配置和性能优化需求。