wodby/mariadb Docker镜像文档

镜像概述

wodby/mariadb 是一个基于 Alpine Linux 的 MariaDB 容器镜像，专为轻量级部署和容器编排场景设计。该镜像继承了 Alpine 系统的轻量级特性（小体积、低资源占用），同时整合了 MariaDB 数据库的核心功能，支持与 Docker Compose、Kubernetes 等主流容器编排工具集成，适用于需要高效资源利用和灵活部署的数据库场景。

核心功能和特性

基础特性

• Alpine Linux 基础：基于 Alpine 构建，镜像体积小（通常小于 100MB），资源占用低，启动速度快。
• MariaDB 核心功能：完整支持 MariaDB 数据库的核心特性，包括关系型数据存储、ACID 事务、SQL 标准兼容、用户权限管理等。

编排与部署支持

• 容器编排集成：优化支持 Docker Compose、Kubernetes 等编排工具，可通过环境变量或配置文件灵活调整部署参数。
• 初始化自动化：支持通过环境变量快速配置数据库（如创建默认库、用户），并可通过初始化脚本自动执行 SQL 或 Shell 命令。

可靠性与可维护性

• 数据持久化：支持通过 Docker 卷（Volume）或绑定挂载（Bind Mount）持久化数据库数据，避免容器重启导致数据丢失。
• 配置灵活性：支持自定义 MariaDB 配置文件（如 my.cnf），可通过环境变量或文件挂载调整数据库参数（如连接数、缓存大小等）。

使用场景和适用范围

主要适用场景

• 开发/测试环境：轻量级部署，快速搭建独立的 MariaDB 实例，适合本地开发或 CI/CD 流程中的测试环节。
• 轻量级生产环境：适用于资源受限的生产场景（如边缘计算、小型应用），通过低资源占用实现高效数据库服务。
• 容器编排集成：需与 Docker Compose 或 Kubernetes 集成的场景，支持通过编排工具管理服务扩缩容、故障恢复等。

不适用场景

• 对数据库性能有极高要求的大规模生产环境（建议使用官方 MariaDB 企业版或针对高性能优化的镜像）。

使用方法和配置说明

基本使用（docker run）

通过 docker run 快速启动一个 MariaDB 实例：

docker run -d \
  --name mariadb \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=rootpass \
  -e MYSQL_DATABASE=appdb \
  -e MYSQL_USER=appuser \
  -e MYSQL_PASSWORD=apppass \
  -v mariadb-data:/var/lib/mysql \
  wodby/mariadb

参数说明：

• -p 3306:3306：映射容器内 MariaDB 默认端口 3306 到主机。
• -e：设置环境变量（详见下文“环境变量配置”）。
• -v mariadb-data:/var/lib/mysql：挂载 Docker 卷 mariadb-data 到容器内数据目录，实现数据持久化。

Docker Compose 配置示例

创建 docker-compose.yml 文件，集成到多容器应用中：

version: '3.8'

services:
  mariadb:
    image: wodby/mariadb
    container_name: app-mariadb
    restart: unless-stopped
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: appdb
      MYSQL_USER: appuser
      MYSQL_PASSWORD: apppass
      MARIADB_INNODB_BUFFER_POOL_SIZE: 256M  # 自定义 InnoDB 缓冲池大小
    volumes:
      - mariadb-data:/var/lib/mysql
      - ./init-scripts:/docker-entrypoint-initdb.d  # 挂载初始化脚本目录
    networks:
      - app-network

volumes:
  mariadb-data:  # 声明持久化卷

networks:
  app-network:
    driver: bridge

配置说明

环境变量

wodby/mariadb 支持通过环境变量配置数据库，常用变量如下：

数据持久化

为避免容器重启或删除导致数据丢失，需通过 Docker 卷或绑定挂载持久化 /var/lib/mysql 目录（MariaDB 数据存储路径）：

• 使用 Docker 卷（推荐）：

  docker volume create mariadb-data  # 创建卷
  docker run -v mariadb-data:/var/lib/mysql ... wodby/mariadb  # 挂载卷
  

• 使用绑定挂载（本地目录）：

  docker run -v /path/on/host/mysql-data:/var/lib/mysql ... wodby/mariadb
  

初始化脚本

容器启动时，会自动执行 /docker-entrypoint-initdb.d 目录下的 .sql、.sql.gz 或 .sh 文件（按文件名排序），可用于初始化数据库结构、插入测试数据等。

示例：

1. 在主机创建 init-scripts 目录，并添加 init.sql：

   -- init.sql
   CREATE TABLE IF NOT EXISTS users (
     id INT PRIMARY KEY AUTO_INCREMENT,
     name VARCHAR(50) NOT NULL
   );
   INSERT INTO users (name) VALUES ('test-user');
   

2. 启动容器时挂载该目录：

   docker run -v ./init-scripts:/docker-entrypoint-initdb.d ... wodby/mariadb
   

注意事项

• 安全性：生产环境中避免使用弱密码，建议通过 Docker Secrets 或 Kubernetes Secrets 管理敏感信息（如 MYSQL_ROOT_PASSWORD）。
• 版本兼容性：镜像标签对应 MariaDB 版本（如 wodby/mariadb:10.6），需根据应用需求选择匹配版本。
• 性能调优：通过 MARIADB_* 环境变量调整数据库参数（如连接数、缓存大小），具体参数参考 MariaDB 官方文档。
• 更新与维护：镜像详细配置和最新特性请参考 官方 GitHub 仓库。