mybbsky/mysql8

MySQL Docker镜像文档

镜像概述

MySQL是全球最受欢迎的开源数据库，以其可靠的性能、稳定性和易用性成为Web应用的首选数据库，适用于从个人项目、网站到大型Web平台（如***、***、***等）的全范围应用场景。

维护者：Docker社区和MySQL团队
获取帮助：Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow
问题反馈：https://github.com/docker-library/mysql/issues
支持架构：amd64、arm64v8
镜像更新：official-images仓库的library/mysql标签

支持的标签及对应Dockerfile链接

• 8.0.31, 8.0, 8, latest, 8.0.31-oracle, 8.0-oracle, 8-oracle, oracle
• 8.0.31-debian, 8.0-debian, 8-debian, debian
• 5.7.40, 5.7, 5, 5.7.40-oracle, 5.7-oracle, 5-oracle
• 5.7.40-debian, 5.7-debian, 5-debian

核心功能与特性

• 高性能：优化的查询处理和事务支持
• 可靠性：数据一致性和故障恢复机制
• 易用性：简化的配置和管理流程
• 灵活性：支持多种存储引擎和扩展插件
• 广泛兼容：适配各类Web应用和开发框架

使用场景

• 个人项目和小型网站的数据存储
• 电子商务平台的交易数据管理
• 企业级信息系统的数据持久化
• 高流量Web应用的后台数据库

使用方法

启动MySQL服务实例

启动MySQL实例非常简单：

bash
docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag

• some-mysql：容器名称
• my-secret-pw：root用户密码
• tag：指定MySQL版本（如8.0、5.7等，见支持标签列表）

通过MySQL命令行客户端连接

启动另一个容器并运行MySQL客户端连接到数据库：

bash
docker run -it --network some-network --rm mysql mysql -hsome-mysql -uexample-user -p

• some-network：Docker网络名称
• some-mysql：目标MySQL容器名称

也可连接非Docker或远程MySQL实例：

bash
docker run -it --rm mysql mysql -hsome.mysql.host -usome-mysql-user -p

使用docker-compose部署

示例stack.yml配置：

yaml
# 使用root/example作为用户/密码凭证
version: '3.1'

services:
  db:
    image: mysql
    # 注意：不推荐使用"mysql_native_password"：https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password
    # （仅为示例，不建议用于生产环境）
    command: --default-authentication-plugin=mysql_native_password
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example

  adminer:
    image: adminer
    restart: always
    ports:
      - 8080:8080

部署命令：

bash
docker-compose -f stack.yml up

访问Adminer管理界面：http://localhost:8080

容器Shell访问与日志查看

进入容器bash shell：

bash
docker exec -it some-mysql bash

查看容器日志：

bash
docker logs some-mysql

使用自定义配置文件

MySQL默认配置位于/etc/mysql/my.cnf，可通过挂载自定义配置目录覆盖：

bash
docker run --name some-mysql -v /my/custom:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag

• /my/custom：主机自定义配置目录（包含.cnf文件）
• 自定义配置会覆盖默认配置

无配置文件的参数配置

可通过命令行参数直接配置mysqld，例如设置默认字符集：

bash
docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci

查看所有可用参数：

bash
docker run -it --rm mysql:tag --verbose --help

环境变量

容器启动时可通过环境变量配置MySQL，已存在数据目录时变量无效。

Docker Secrets

通过_FILE后缀从文件加载敏感信息（支持MYSQL_ROOT_PASSWORD、MYSQL_ROOT_HOST、MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD）：

bash
docker run --name some-mysql -e MYSQL_ROOT_PASSWORD_FILE=/run/secrets/mysql-root -d mysql:tag

初始化新实例

首次启动容器时，会创建指定数据库并执行/docker-entrypoint-initdb.d目录下的.sh、.sql、.sql.gz文件（按字母顺序执行）。可挂载SQL文件到该目录初始化数据：

bash
docker run --name some-mysql -v /my/init-scripts:/docker-entrypoint-initdb.d -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag

注意事项

数据存储位置

推荐两种数据持久化方式：

1. Docker卷管理：默认方式，数据存储在主机Docker内部卷
2. 主机目录挂载：将主机目录挂载到容器/var/lib/mysql：

   bash
   docker run --name some-mysql -v /my/own/datadir:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag
   

   • /my/own/datadir：主机数据目录

初始化完成前无法连接

首次启动时数据库初始化期间无法接受连接，自动化部署需实现连接重试逻辑（参考WordPress或Bonita镜像的实现）。

使用现有数据库

若数据目录已存在数据库（含mysql子目录），启动时需省略MYSQL_ROOT_PASSWORD，系统会保留现有数据库。

以任意用户运行

指定UID/GID运行（需确保目录权限正确）：

bash
mkdir data
docker run -v "$PWD/data":/var/lib/mysql --user 1000:1000 --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag

数据库备份与恢复

备份：

bash
docker exec some-mysql sh -c 'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' > /some/path/all-databases.sql

恢复：

bash
docker exec -i some-mysql sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD"' < /some/path/all-databases.sql

许可证

查看镜像中软件的许可证信息。镜像可能包含其他软件（如Bash等），其许可证需另行确认。用户需确保使用该镜像符合所有包含软件的许可证要求。