dpvduncan/mariadb

MariaDB Docker镜像文档

镜像概述

MariaDB是一款开源的关系型数据库管理系统（RDBMS），由MySQL原开发团队创建，旨在保持与MySQL的高度兼容性，同时提供更优的性能、安全性和功能扩展。MariaDB Docker镜像将MariaDB数据库封装为容器，简化了部署流程，支持快速搭建独立的数据库环境，适用于开发、测试及生产场景的数据存储与管理需求。

核心功能与特性

1. 兼容性

• 与MySQL协议和语法高度兼容，可无缝迁移MySQL应用
• 支持MySQL客户端工具及API（如JDBC、ODBC）

2. 开源与免费

• 基于GPL许可协议，完全开源免费，无商业使用限制
• 活跃的社区支持，持续更新维护

3. 性能优化

• 内置查询优化器，提升复杂查询执行效率
• 支持线程池、缓存机制，降低资源占用
• 多存储引擎支持（InnoDB、MyISAM、Aria等），适配不同业务场景

4. 安全性

• 支持数据加密（传输加密、存储加密）
• 细粒度权限控制，支持角色管理
• 定期安全更新，修复漏洞

5. 功能扩展

• 支持JSON数据类型及操作
• 全文搜索、地理信息处理（GIS）功能
• 内置备份工具（mysqldump、mariabackup）

使用场景与适用范围

1. Web应用开发

• 作为Web应用后端数据库，存储用户数据、业务数据
• 支持高并发访问，适配电商、社交、内容管理系统（CMS）等场景

2. 企业级数据管理

• 企业内部业务系统数据存储（如ERP、CRM系统）
• 数据仓库构建，支持数据分析与报表生成

3. 开发与测试环境

• 快速搭建隔离的数据库环境，避免本地环境配置冲突
• 支持容器化CI/CD流程，与自动化测试集成

4. 嵌入式与边缘计算

• 轻量级部署特性，适用于资源受限的嵌入式设备或边缘节点

使用方法与配置说明

基本部署（docker run）

通过以下命令快速启动MariaDB容器：

bash
docker run -d \
  --name mariadb \
  -p 3306:3306 \
  -e MARIADB_ROOT_PASSWORD=mysecretpassword \
  -v mariadb-data:/var/lib/mysql \
  mariadb:latest

参数说明：

• -d：后台运行容器
• --name mariadb：指定容器名称
• -p 3306:3306：映射容器3306端口到主机（数据库默认端口）
• -e MARIADB_ROOT_PASSWORD：设置root用户密码（必填）
• -v mariadb-data:/var/lib/mysql：使用命名卷持久化数据（避免容器删除后数据丢失）

环境变量配置

MariaDB镜像支持通过环境变量自定义配置，常用变量如下：

示例：创建带初始数据库和用户的容器

bash
docker run -d \
  --name mariadb-app \
  -p 3306:3306 \
  -e MARIADB_ROOT_PASSWORD=rootpass \
  -e MARIADB_DATABASE=mydb \
  -e MARIADB_USER=appuser \
  -e MARIADB_PASSWORD=apppass \
  -v mariadb-data:/var/lib/mysql \
  mariadb:latest

Docker Compose配置

使用docker-compose.yml简化多容器应用中的数据库部署：

yaml
version: '3.8'
services:
  mariadb:
    image: mariadb:latest
    container_name: mariadb
    restart: always  # 容器退出时自动重启
    ports:
      - "3306:3306"
    environment:
      MARIADB_ROOT_PASSWORD: rootpass
      MARIADB_DATABASE: mydb
      MARIADB_USER: appuser
      MARIADB_PASSWORD: apppass
    volumes:
      - mariadb-data:/var/lib/mysql  # 数据持久化
      - ./init-scripts:/docker-entrypoint-initdb.d  # 初始化脚本目录（可选）
    networks:
      - app-network  # 与应用共享网络

volumes:
  mariadb-data:  # 命名卷，数据持久化

networks:
  app-network:
    driver: bridge

初始化脚本说明：

将SQL脚本（.sql、.sql.gz）或Shell脚本（.sh）放入./init-scripts目录，容器启动时会自动执行，用于初始化表结构、插入测试数据等。

数据持久化

为避免容器删除导致数据丢失，需通过以下方式持久化数据：

1. 命名卷（推荐）：如上述示例中使用-v mariadb-data:/var/lib/mysql，卷由Docker管理，安全性高。

2. 主机目录挂载：将主机目录直接挂载到容器，适合需要直接访问数据文件的场景：

   bash
   docker run -d \
     --name mariadb \
     -v /path/on/host/mysql-data:/var/lib/mysql \
     mariadb:latest
   

网络配置

• 连接到容器内数据库：

  bash
  docker exec -it mariadb mysql -u root -p
  

• 从其他容器连接：通过容器名称或服务名（Docker Compose）访问，例如在应用容器中连接字符串为：

  mysql://appuser:apppass@mariadb:3306/mydb
  

• 限制外部访问：生产环境建议不暴露3306端口到公网，通过Docker网络隔离，仅允许应用容器访问。

日志管理

容器日志默认输出到标准输出，可通过Docker日志驱动配置存储位置：

bash
docker run -d \
  --name mariadb \
  --log-driver=json-file \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  mariadb:latest

或在docker-compose.yml中配置：

yaml
services:
  mariadb:
    # ...其他配置
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

版本选择

MariaDB镜像提供多个标签，对应不同版本，可根据需求选择：

• latest：最新稳定版
• 11.4：特定主版本（如11.4.x系列）
• 11.4.2：特定补丁版本
• 11.4-focal：基于Ubuntu Focal的版本
• 11.4-alpine：基于Alpine Linux的轻量版本（体积更小，适合资源受限环境）

建议生产环境使用特定版本标签（如11.4.2），避免latest标签自动更新导致兼容性问题。

安全注意事项

1. 避免使用空密码：生产环境必须设置MARIADB_ROOT_PASSWORD，并使用强密码。
2. 限制root用户访问：通过MARIADB_ROOT_HOST限制仅允许特定IP或主机登录。
3. 定期更新镜像：及时拉取官方镜像更新，修复安全漏洞。
4. 数据备份：定期通过docker exec mariadb mysqldump或mariabackup备份数据。
5. 最小权限原则：应用使用非root用户（如示例中的appuser）访问数据库，避免权限过大。