loselesslive/mysql8

MySQL 预配置认证插件镜像

镜像概述和主要用途

本镜像基于官方MySQL镜像构建，预配置了default_authentication_plugin = mysql_native_password参数，旨在解决因MySQL默认认证插件变更（如caching_sha2_password）导致的旧版客户端连接兼容性问题。主要用于需要快速部署MySQL数据库且需使用mysql_native_password认证机制的场景，简化配置流程，降低部署复杂度。

核心功能和特性

• 预配置认证插件：默认启用mysql_native_password认证插件，无需手动修改my.cnf配置文件
• 兼容性保障：确保与仅支持mysql_native_password的旧版客户端（如部分ORM工具、旧版应用程序）正常通信
• 保留官方特性：继承MySQL官方镜像的全部功能，包括数据持久化、环境变量配置等
• 开箱即用：无需额外配置即可直接启动，减少部署步骤

使用场景和适用范围

• 需连接旧版MySQL客户端（如MySQL 5.x客户端）的应用环境
• 开发/测试环境中需要快速搭建兼容旧认证机制的MySQL服务
• 生产环境中需维持与遗留系统兼容性的MySQL部署
• 自动化部署流程中需要标准化MySQL配置的场景

使用方法和配置说明

Docker Run 快速启动

bash
docker run -d \
  --name mysql-native \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=your_strong_password \
  -v mysql-data:/var/lib/mysql \
  your-image-name:tag

Docker Compose 配置示例

yaml
version: '3'
services:
  mysql:
    image: your-image-name:tag
    container_name: mysql-native
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: your_strong_password
      MYSQL_DATABASE: your_db_name
      MYSQL_USER: your_user
      MYSQL_PASSWORD: your_user_password
    volumes:
      - mysql-data:/var/lib/mysql
    restart: unless-stopped

volumes:
  mysql-data:

环境变量说明

支持MySQL官方镜像的所有标准环境变量，主要包括：

• MYSQL_ROOT_PASSWORD：必填，设置root用户密码
• MYSQL_DATABASE：可选，启动时自动创建的数据库名称
• MYSQL_USER：可选，创建的普通用户名
• MYSQL_PASSWORD：可选，普通用户的密码
• MYSQL_ALLOW_EMPTY_PASSWORD：可选，允许空密码（不推荐生产环境）
• MYSQL_RANDOM_ROOT_PASSWORD：可选，自动生成随机root密码

配置验证

容器启动后，可通过以下命令验证配置是否生效：

bash
docker exec -it mysql-native mysql -uroot -p -e "SHOW VARIABLES LIKE 'default_authentication_plugin';"

预期输出应显示：default_authentication_plugin | mysql_native_password

注意事项

• 生产环境中应使用数据卷（volume）持久化数据，避免容器删除导致数据丢失
• 建议定期更新镜像以获取MySQL官方安全补丁
• 若需自定义其他MySQL配置，可通过挂载my.cnf文件实现（会覆盖默认配置）