in2code/mysql

MySQL Docker镜像文档

镜像概述

本镜像为预配置的MySQL数据库容器，支持MySQL 5.5至8.9版本，默认启用utf8和utf8mb4字符集，无需额外配置即可支持多语言及特殊字符（如emoji）存储。镜像简化了MySQL的部署流程，适用于各类需要快速搭建MySQL环境的场景。

核心功能与特性

• 多版本支持：涵盖MySQL 5.5、5.6、5.7、8.0至8.9等主流版本，满足不同应用的版本依赖需求。
• 默认字符集：预配置utf8（3字节）和utf8mb4（4字节）字符集，默认字符集为utf8mb4，支持完整的Unicode字符集。
• 即开即用：无需手动修改配置文件启用字符集，容器启动后自动应用预设字符集配置。
• 兼容性：与官方MySQL镜像接口完全兼容，支持标准MySQL环境变量、配置参数及数据持久化方式。

使用场景

• 开发环境：本地开发时快速搭建独立的MySQL服务，避免本地环境配置冲突。
• 测试环境：支持多版本切换，验证应用在不同MySQL版本下的兼容性。
• 小型生产环境：适用于轻量级应用或微服务，简化数据库部署与维护流程。

使用方法与配置说明

基本使用（docker run）

通过以下命令快速启动MySQL容器：

bash
docker run -d \
  --name mysql-instance \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  -p 3306:3306 \
  [镜像名称]:[版本标签]

• [镜像名称]：镜像的具体名称（如未指定，可替换为实际镜像标识）。
• [版本标签]：指定MySQL版本，支持5.5、5.6、5.7、8.0、8.1、...、8.9（如不指定，默认使用最新版本）。

环境变量配置

支持官方MySQL镜像的所有标准环境变量，常用配置如下：

示例（创建自定义数据库和用户）：

bash
docker run -d \
  --name mysql-dev \
  -e MYSQL_ROOT_PASSWORD=root123 \
  -e MYSQL_DATABASE=app_db \
  -e MYSQL_USER=app_user \
  -e MYSQL_PASSWORD=app_pass \
  -p 3306:3306 \
  [镜像名称]:8.0

数据持久化

为避免容器删除导致数据丢失，建议通过数据卷挂载MySQL数据目录：

bash
docker run -d \
  --name mysql-persistent \
  -e MYSQL_ROOT_PASSWORD=root123 \
  -v /host/path/to/mysql/data:/var/lib/mysql \
  -p 3306:3306 \
  [镜像名称]:5.7

• /host/path/to/mysql/data：宿主机上用于存储MySQL数据的目录。

字符集验证

容器启动后，可通过以下步骤验证字符集配置：

1. 进入容器：

   bash
   docker exec -it mysql-instance mysql -u root -p
   

2. 输入root密码后，执行SQL查询：

   sql
   SHOW VARIABLES LIKE 'character_set_%';
   

3. 确认关键参数值：
   • character_set_client：utf8mb4
   • character_set_connection：utf8mb4
   • character_set_database：utf8mb4
   • character_set_server：utf8mb4

自定义配置

如需修改额外配置（如端口、缓存大小等），可通过挂载自定义配置文件实现：

bash
docker run -d \
  --name mysql-custom \
  -e MYSQL_ROOT_PASSWORD=root123 \
  -v /host/path/to/my.cnf:/etc/mysql/conf.d/custom.cnf \
  -p 3306:3306 \
  [镜像名称]:8.9

• 自定义配置文件需放置于/etc/mysql/conf.d/目录下，容器启动时会自动加载。

版本支持说明

注：版本标签与官方MySQL版本号完全一致，可通过指定标签精确控制使用的MySQL版本。