MySQL Docker镜像文档

镜像概述

本镜像是MySQL数据库的Docker化部署方案，提供便捷的MySQL服务部署方式，支持自定义配置文件、数据持久化存储及root用户密码初始化，适用于开发、测试及轻量级生产环境。

核心功能与特性

• 自定义配置：支持通过外部挂载自定义my.cnf配置文件
• 数据持久化：通过数据卷存储数据库数据，避免容器销毁导致数据丢失
• 密码管理：支持初始化root用户密码（9.3.1及以上版本）
• 故障处理：提供首次运行错误解决方案及容器内服务管理方法

使用场景

• 需要快速部署MySQL服务的开发/测试环境
• 需自定义MySQL配置参数（如端口、字符集、连接数等）的场景
• 要求数据持久化存储的MySQL部署需求

使用方法

基础用法

快速启动默认配置的MySQL服务：

bash
docker run -itd -p 3306:3306 --name mysql shinejh0528/mysql:9.3.1

自定义配置用法

通过外部my.cnf文件自定义配置，需挂载配置卷和数据卷：

bash
docker run -itd -p 3306:3306 \
  -v /data/mysql_docker_test/:/data/mysql \
  -v ~/script/docker/mysql/1.1.0/config:/data/config \
  -e mycnf=/data/config/my.cnf \
  -e root_password=root \
  --name mysql shinejh0528/mysql:9.3.1

参数说明

• 数据卷挂载：

  • /data/mysql：存储my.cnf中指定的MySQL数据库数据（数据持久化目录）
  • /data/config：存储自定义my.cnf配置文件（需包含/data/config/my.cnf）

• 环境变量：

  • -e mycnf：自定义my.cnf文件路径（示例中为/data/config/my.cnf）
  • -e root_password：root用户初始密码（shinejh0528/mysql:9.3.1及以上版本支持，默认值为root）

配置参数说明

故障排除

容器内启动MySQL服务

若容器内MySQL服务未运行，可通过以下命令启动：

bash
docker exec -it [容器ID] /bin/bash
service mysql start

查看当前my.cnf配置

检查容器内正在使用的MySQL配置文件：

bash
cat /etc/mysql/my.cnf

首次运行错误处理

服务器首次通过Docker运行MySQL时可能遇到初始化错误，按以下步骤解决：

1. 初始化MySQL：

bash
mysqld --initialize-insecure --user=mysql

2. 启动MySQL服务：

bash
service mysql start
# 修改root密码（如需）
mysql -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED BY 'root'; FLUSH PRIVILEGES;"

my.cnf配置示例

以下是自定义my.cnf的示例配置：

ini
[mysqld]
#port=3307
datadir=/data/mysql
log-bin=/data/mysql/mysql-bin.log
server-id = 1
expire_logs_days = 10
max_binlog_size = 100M
log_bin_trust_function_creators = 1
collation-server = utf8mb4_general_ci
default-time-zone = "+09:00"
max_connections = 500
pid-file = /var/run/mysqld/mysqld.pid

[mysqldump]
default-character-set = utf8mb4

[mysql]
default-character-set = utf8mb4