sensei73/mariadb

MariaDB 5.5 Docker镜像文档

镜像概述

本镜像基于MariaDB 5.5版本构建，提供了快速部署MariaDB数据库服务的解决方案。通过Docker容器化方式，简化了MariaDB的安装和配置流程，支持数据持久化存储，确保服务重启后数据不丢失。

核心功能与特性

• 数据持久化：通过挂载宿主机目录实现数据库数据持久化存储
• 时间同步：支持挂载宿主机本地时间文件，确保数据库时间准确性
• 端口映射：默认映射3306端口，方便外部访问数据库服务
• 轻量部署：基于Docker容器，简化部署流程，减少环境配置复杂度

使用场景

• 开发测试环境中的MariaDB数据库服务搭建
• 需要快速部署MariaDB 5.5版本的应用场景
• 对数据持久化有需求的轻量级数据库部署

使用方法

基本运行命令

bash
docker run -d --name="mariadb" -v /path/to/db:/db -v /etc/localtime:/etc/localtime:ro -p 3306:3306 oppsig/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 bash
2. 登录数据库：mysql -u root
3. 创建用户并设置密码：CREATE USER 'username'@'host' IDENTIFIED BY 'password';
4. 授予权限：GRANT ALL PRIVILEGES ON *.* TO 'username'@'host';
5. 刷新权限：FLUSH PRIVILEGES;

返回用户（数据迁移）

如果需要迁移已有数据库数据：

1. 重要：先备份原有数据库数据
2. 将原MySQL或MariaDB的数据目录完整复制到宿主机的/path/to/db目录
3. 按照基本运行命令启动容器，容器将自动使用挂载的现有数据

数据目录结构示例

新生成的/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    16384 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
18432 -rw-rw---- 1 mysql  mysql 18874368 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/

注意事项

• 数据安全：使用前务必进行数据库安全配置（创建用户、设置密码）
• 数据备份：迁移或升级前请备份原有数据库数据，避免数据丢失
• 版本兼容性：本镜像仅支持MariaDB 5.5版本，不保证与其他版本数据文件兼容