freenas/mariadb

MariaDB

!https://raw.githubusercontent.com/docker-library/docs/74e3b3d4d60389208732dbd2c95145868111d959/mariadb/logo.png

镜像概述

MariaDB是MySQL关系型数据库管理系统的社区开发分支，旨在遵循GNU GPL协议保持免费。作为领先开源软件系统的分支，其显著特点是由MySQL原开发团队领导——因Oracle收购MySQL引发担忧而创建此分支。贡献者需将版权共享给MariaDB基金会。该镜像致力于与MySQL保持高度兼容性，确保“即插即用”的替换能力，包括库二进制等效性以及与MySQL API和命令的完全匹配。

核心功能与特性

• 高度兼容性：作为MySQL的“drop-in”替代品，实现库二进制等效，API和命令与MySQL完全匹配，支持平滑迁移
• 增强存储引擎：包含XtraDB存储引擎（替代InnoDB）和Aria存储引擎（兼具事务和非事务处理能力，可能被未来MySQL版本采用）
• 社区驱动：由MariaDB基金会管理，确保开源免费属性，持续接收社区贡献和优化

使用场景与适用范围

• 需要开源关系型数据库的个人或企业项目
• 寻求MySQL替代方案，关注许可证自由性的场景
• 要求与MySQL高度兼容，需平滑迁移现有MySQL应用的环境
• 需要增强存储引擎功能（如XtraDB性能优化、Aria多模式处理）的业务场景

使用方法与配置说明

基本部署（docker run）

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

bash
docker run --name some-mariadb \
  -e MYSQL_ROOT_PASSWORD=my-secret-pw \  # 必须设置：root用户密码
  -p 3306:3306 \                        # 端口映射：主机端口:容器端口
  -v mariadb_data:/var/lib/mysql \       # 数据卷挂载：持久化数据
  -d mariadb:latest                     # 后台运行，使用最新镜像

Docker Compose配置

创建docker-compose.yml文件进行编排部署：

yaml
version: '3.8'
services:
  mariadb:
    image: mariadb:latest
    container_name: mariadb
    environment:
      MYSQL_ROOT_PASSWORD: my-secret-pw    # root用户密码（必填）
      MYSQL_DATABASE: mydb                 # 自动创建的数据库名称
      MYSQL_USER: myuser                   # 自动创建的普通用户
      MYSQL_PASSWORD: mypass               # 普通用户密码
    ports:
      - "3306:3306"                       # 端口映射
    volumes:
      - mariadb_data:/var/lib/mysql        # 数据持久化卷
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql  # 初始化SQL脚本
    restart: unless-stopped                # 除非手动停止，否则自动重启

volumes:
  mariadb_data:  # 命名卷，确保数据持久化

环境变量说明

数据持久化

为避免容器删除导致数据丢失，需通过卷挂载持久化数据目录：

• 推荐使用命名卷（如上述示例中的mariadb_data）
• 也可使用主机目录挂载：-v /path/on/host:/var/lib/mysql

官方文档

完整配置与高级用法请参考官方Docker文档：
https://hub.docker.com/_/mariadb/