jkleczkowski/mariadb

MariaDB Docker镜像文档

镜像概述

本镜像为MariaDB数据库的Docker镜像，基于Docker官方MariaDB镜像构建，核心特点是支持通过环境变量自定义服务器字符集和排序规则，适用于需要特定字符集配置的数据库场景。

核心功能与特性

• 自定义字符集配置：通过CHARACTER_SET_SERVER环境变量设置服务器默认字符集
• 自定义排序规则：通过COLLATION_SERVER环境变量设置服务器默认排序规则
• 包含MariaDB数据库服务器完整功能，支持标准SQL操作
• 轻量级部署，易于集成到各类开发、测试和生产环境

使用场景

• 需要特定字符集（如UTF-8）的应用开发环境
• 多语言应用的数据库服务部署
• 快速搭建具有自定义字符集配置的MariaDB测试环境
• 对字符编码有特殊要求的数据库服务场景

使用方法与配置说明

基本运行命令

通过以下命令启动MariaDB容器，同时自定义字符集和排序规则：

bash
docker run -it --rm --name mariadb \
  -e CHARACTER_SET_SERVER="utf8" \
  -e COLLATION_SERVER="utf8_general_ci" \
  -e MYSQL_ROOT_PASSWORD="P@ssw0rd" \
  -p 3306:3306 \
  jkleczkowski/mariadb

环境变量说明

端口映射

默认使用MariaDB标准端口3306，通过-p 3306:3306参数将容器内端口映射到主机，允许外部应用访问数据库服务。

数据持久化配置

如需持久化存储数据库数据，可添加数据卷挂载：

bash
docker run -it --rm --name mariadb \
  -e CHARACTER_SET_SERVER="utf8" \
  -e COLLATION_SERVER="utf8_general_ci" \
  -e MYSQL_ROOT_PASSWORD="P@ssw0rd" \
  -p 3306:3306 \
  -v /host/path/mysql-data:/var/lib/mysql \
  jkleczkowski/mariadb

其中/host/path/mysql-data为宿主机上用于存储数据库数据的目录。

注意事项

• MYSQL_ROOT_PASSWORD为必填环境变量，未设置将导致容器启动失败
• 字符集与排序规则需匹配使用，例如utf8字符集对应utf8_general_ci排序规则
• 如需高级配置，可通过挂载自定义配置文件到/etc/mysql/conf.d/目录实现