clover/mysql

MySQL Docker镜像文档

1. 镜像概述和主要用途

MySQL是一款广泛使用的开源关系型数据库管理系统（RDBMS）。本Docker镜像基于Ubuntu系统的官方MySQL客户端与服务器软件包构建，并以clover/perl-base为基础镜像，旨在提供轻量、易用的MySQL数据库运行环境。其核心用途包括数据库服务部署、数据存储与管理，支持通过初始化脚本快速配置数据库结构。

2. 核心功能和特性

• 基于官方组件：采用Ubuntu官方MySQL客户端及服务器软件包，确保兼容性与稳定性。
• 数据持久化：默认数据存储路径为/var/lib/mysql，支持通过Docker数据卷实现数据持久化。
• 自动初始化：首次运行时，将通过/usr/share/mysql/init.sql脚本自动初始化数据库结构。
• 默认安全配置：初始root用户密码预设为root，简化首次访问流程（建议生产环境修改）。

3. 使用场景和适用范围

• 开发环境：快速搭建本地MySQL服务，用于应用程序开发调试。
• 测试环境：配合自动化测试框架，提供隔离的数据库实例。
• 轻量级生产环境：适用于数据量较小、访问压力较低的业务场景（需额外配置安全策略）。

4. 使用方法和配置说明

4.1 基本运行命令

通过docker run启动容器，示例如下（假设镜像名称为clover/mysql）：

bash
docker run -d \
  -p 3306:3306 \  # 映射容器3306端口到主机
  -v mysql-data:/var/lib/mysql \  # 挂载数据卷以持久化数据
  --name mysql-instance \  # 容器名称
  clover/mysql  # 镜像名称

4.2 数据卷配置

• 数据存储路径：容器内MySQL数据默认存储于/var/lib/mysql，建议通过Docker数据卷（如示例中的mysql-data）或主机目录挂载该路径，避免容器删除导致数据丢失。
• 数据卷创建：若需手动创建数据卷，可执行：

  bash
  docker volume create mysql-data
  

4.3 初始化脚本

• 默认初始化：首次启动容器时，系统将自动执行/usr/share/mysql/init.sql脚本，完成数据库初始化（如创建默认数据库、表结构等）。
• 自定义初始化：如需使用自定义初始化脚本，可通过挂载主机脚本文件至容器内该路径实现：

  bash
  docker run -d \
    -v /path/to/custom-init.sql:/usr/share/mysql/init.sql \  # 挂载自定义初始化脚本
    -v mysql-data:/var/lib/mysql \
    --name mysql-instance \
    clover/mysql
  

4.4 访问与密码配置

• 默认密码：初始root用户密码为root，可通过MySQL客户端连接验证：

  bash
  mysql -h localhost -P 3306 -u root -p  # 输入密码root
  

• 密码修改：建议首次登录后立即修改root密码：

  sql
  ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_password';
  FLUSH PRIVILEGES;
  

4.5 端口映射

默认MySQL服务端口为3306，需通过-p参数映射至主机端口（如示例中的3306:3306），允许外部访问。若主机3306端口被占用，可修改主机端口（如3307:3306）。

5. 注意事项

• 生产环境安全：默认密码仅适用于开发/测试场景，生产环境需通过修改root密码、限制网络访问（如--network指定隔离网络）等方式增强安全性。
• 初始化脚本执行时机：init.sql仅在首次启动（数据卷为空时）执行，后续重启容器不会重复执行。
• 镜像依赖：基于clover/perl-base构建，运行前需确保该基础镜像已拉取（Docker将自动拉取依赖）。