needo/mariadb

MariaDB 5.5 Docker镜像文档

镜像概述

本镜像基于MariaDB 5.5版本构建，提供轻量级、可移植的数据库服务环境。通过Docker容器化部署，简化MariaDB的安装与配置流程，支持数据持久化存储和系统时间同步，适用于各类需要MariaDB 5.5数据库支持的应用场景。

核心功能与特性

• 数据持久化：通过挂载本地目录实现数据库数据的持久化存储，避免容器重启导致数据丢失
• 时间同步：支持挂载本地系统时间文件(/etc/localtime)，确保数据库时间与宿主机一致
• 标准端口映射：默认映射3306端口，符合MySQL/MariaDB标准访问方式
• 轻量部署：基于官方MariaDB 5.5构建，镜像体积小，启动速度快

使用场景

• 开发环境数据库服务搭建
• 测试环境数据库功能验证
• 小型应用或个人项目的数据库后端
• 需要快速部署MariaDB 5.5环境的场景

使用方法与配置说明

基本运行命令

bash
docker run -d --name="mariadb" -v /path/to/db:/db -v /etc/localtime:/etc/localtime:ro -p 3306:3306 needo/mariadb

参数说明：

• -d：后台运行容器
• --name="mariadb"：指定容器名称为"mariadb"
• -v /path/to/db:/db：将本地目录/path/to/db挂载到容器内/db目录，用于数据持久化
• -v /etc/localtime:/etc/localtime:ro：挂载本地时间文件，确保容器时间与宿主机同步（只读权限）
• -p 3306:3306：将容器3306端口映射到宿主机3306端口，允许外部访问数据库

首次使用注意事项

• 首次运行时，镜像会自动生成一个全新的空数据库环境
• 必须手动创建用户和密码以确保数据库安全，建议执行以下操作：
  1. 进入容器：docker exec -it mariadb mysql -u root
  2. 创建管理员用户并授权：CREATE USER 'admin'@'%' IDENTIFIED BY 'your_strong_password';
  3. 赋予权限：GRANT ALL PRIVILEGES ON *.* TO 'admin'@'%' WITH GRANT OPTION;
  4. 刷新权限：FLUSH PRIVILEGES;

返回用户注意事项

• 重要：在迁移数据前，务必备份原始数据库数据，避免数据丢失
• 将原MySQL或MariaDB的数据目录完整复制到本地挂载路径/path/to/db/
• 容器启动时会自动识别并使用已有的数据目录

数据目录结构示例

新生成的/path/to/db/目录结构如下：

total 28692
    0 drwx------ 1 mysql  root       170 Jun 24 10:21 ./
    0 drwxrwxrwx 1 nobody users        8 Jun 24 10:18 ../
   16 -rw-rw---- 1 mysql  mysql    *** Jun 24 10:21 aria_log.00000001
    4 -rw-rw---- 1 mysql  mysql       52 Jun 24 10:21 aria_log_control
 5120 -rw-rw---- 1 mysql  mysql  5242880 Jun 24 10:21 ib_logfile0
 5120 -rw-rw---- 1 mysql  mysql  5242880 Jun 24 10:18 ib_logfile1
*** -rw-rw---- 1 mysql  mysql *** Jun 24 10:18 ibdata1
    0 drwx------ 1 mysql  root      2094 Jun 24 10:18 mysql/
    0 drwx------ 1 mysql  mysql      868 Jun 24 10:21 performance_schema/