brightbox/mysql

MySQL 本地化镜像（GB Locale）

镜像概述

本镜像基于官方MySQL镜像构建，核心特点是预配置了GB locale及其他必要的环境优化设置。它继承了官方MySQL的全部功能特性，同时解决了中文环境下常见的本地化配置问题，用户可直接部署使用，无需手动调整locale参数。

核心功能与特性

• 官方兼容性：完全基于官方MySQL镜像构建，与官方最新稳定版本保持同步，兼容性良好
• GB locale预配置：已预先配置GB相关locale（如zh_CN.UTF-8），支持中文数据的存储、检索和显示，避免中文乱码
• 优化设置集成：包含字符集默认配置、时区优化等实用环境设置，提升中文环境下的使用便捷性

使用场景与适用范围

• 国内企业应用系统的数据库服务
• 中文网站或应用的后台数据存储
• 需要处理中文文本数据的业务系统
• 对本地化配置有要求的开发/测试环境
• 希望减少部署步骤的中文环境应用

使用方法与配置说明

基本部署

Docker Run 命令示例

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

Docker Compose 配置示例

yaml
version: '3.8'

services:
  mysql:
    image: [镜像名称]:[版本标签]
    container_name: mysql-gb
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: your_strong_password
      MYSQL_DATABASE: app_db  # 可选：启动时自动创建数据库
      MYSQL_USER: app_user    # 可选：创建应用专用用户
      MYSQL_PASSWORD: app_pass # 可选：应用用户密码
    ports:
      - "3306:3306"
    volumes:
      - mysql-data:/var/lib/mysql  # 数据持久化
      - ./conf:/etc/mysql/conf.d   # 自定义配置挂载点

volumes:
  mysql-data:

自定义配置

如需覆盖默认配置，可通过挂载配置文件实现。在主机创建配置目录并添加自定义配置文件（如custom.cnf）：

ini
[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
default-time-zone = '+08:00'  # 设置北京时间时区
max_connections=1000          # 连接数调整

挂载到容器的/etc/mysql/conf.d目录，MySQL会自动加载该配置。

配置参数说明

环境变量

支持官方MySQL镜像的所有标准环境变量，主要常用参数如下：

注意事项

• 镜像中的GB locale配置已包含字符集默认设置，通常无需额外配置即可支持中文
• 生产环境建议使用Docker卷（volume）而非主机目录存储数据，提高安全性
• 敏感信息（如密码）建议通过环境变量注入或使用Docker Secrets管理

版本信息

• 基础镜像：官方MySQL（具体版本需查看镜像标签）
• 支持架构：amd64、arm64等官方支持的架构