elestio/mariadb

MariaDB（由Elestio验证和打包）

镜像概述和主要用途

MariaDB 是一款开源关系型数据库管理系统，兼容 MySQL，广泛用于企业级应用和 Web 开发的数据存储。Elestio 提供的 MariaDB 镜像经过验证和打包，旨在提供稳定、高效且易于部署的数据库服务。该镜像与官方版本同步更新，确保用户及时获取最新功能和安全修复，适合需要可靠数据库支持的各类应用场景。

核心功能和特性

MariaDB 本身特性

• 开源免费：基于 GPL 许可协议，可自由使用、修改和分发。
• 兼容 MySQL：支持 MySQL 的 API 和命令，可无缝迁移现有 MySQL 应用。
• 高性能：优化的查询处理、事务支持和并发控制，适合高负载场景。
• 丰富存储引擎：支持 InnoDB、MyISAM、Aria 等多种存储引擎，满足不同需求。
• 安全可靠：提供数据加密、访问控制和审计功能，保障数据安全。

Elestio 镜像优势

• 及时更新：与官方版本同步，通过自动化流程快速发布新版本，确保用户获取最新 bug 修复和功能。
• 质量控制：Elestio 团队进行严格的质量检测，确保镜像符合高可用性和稳定性标准。
• 易于部署：提供完整的 Docker Compose 配置和环境变量管理，简化部署流程。

使用场景和适用范围

• 企业级应用：作为核心数据库支持业务系统、CRM、ERP 等企业应用的数据存储。
• Web 开发：为博客、电商平台、内容管理系统（CMS）等 Web 应用提供后端数据存储。
• 开发与测试：适合开发环境中快速搭建数据库服务，支持 CI/CD 流程集成。
• 中小规模数据存储：满足中小型项目对结构化数据的存储、查询和事务处理需求。

使用方法和配置说明

前置要求

• 安装 Docker 和 Docker Compose。
• 具备 Git 环境（用于克隆部署仓库）。

部署步骤

1. 克隆代码仓库

通过 Git 克隆 Elestio MariaDB 部署仓库：

bash
git clone https://github.com/elestio-examples/mariadb.git
cd mariadb

2. 配置环境变量

复制测试环境的 .env 文件到项目根目录，并编辑自定义配置：

bash
cp ./tests/.env ./.env

使用文本编辑器修改 .env 文件，设置自定义密码、数据库名称等参数（详见下方环境变量说明）。

3. 启动服务

通过 Docker Compose 启动 MariaDB 和 phpMyAdmin（Web 管理界面）：

bash
docker-compose up -d

4. 访问服务

• 数据库连接：通过数据库客户端连接 your-domain:3306（默认端口）。
• Web 管理界面（phpMyAdmin）：访问 http://your-domain:24581，使用配置的用户名和密码登录。

Docker Compose 配置示例

以下是完整的 docker-compose.yml 配置示例：

yaml
version: "3.3"
services:
  mariadb:
    image: elestio/mariadb:${SOFTWARE_VERSION_TAG}
    volumes:
      - data:/var/lib/mysql  # 数据持久化存储
    environment:
      MYSQL_ROOT_PASSWORD: ${SOFTWARE_PASSWORD}  # root 用户密码
      MYSQL_DATABASE: ${MYSQL_DATABASE}          # 初始化数据库名称
      MYSQL_USER: ${MYSQL_USER}                  # 自定义数据库用户
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}          # 自定义用户密码
    ports:
      - "172.17.0.1:3306:3306"  # 映射数据库端口
    restart: on-failure         # 故障时自动重启

  pma:  # phpMyAdmin 服务（可选）
    image: phpmyadmin/phpmyadmin
    restart: always
    links:
      - mariadb:mariadb  # 关联 MariaDB 服务
    ports:
      - "172.17.0.1:24581:80"  # Web 管理界面端口
    environment:
      PMA_HOST: ${PMA_HOST}          # 数据库主机（mariadb 服务名）
      PMA_PORT: ${PMA_PORT}          # 数据库端口（3306）
      PMA_USER: ${PMA_USER}          # 登录用户名（默认 root）
      PMA_PASSWORD: ${SOFTWARE_PASSWORD}  # 登录密码（root 密码）
      UPLOAD_LIMIT: ${UPLOAD_LIMIT}  # 导入文件大小限制
    depends_on:
      - mariadb  # 依赖 MariaDB 服务启动

volumes:
  data:  # 持久化卷定义

环境变量说明

维护与管理

日志查看

通过 Docker Compose 查看服务日志：

bash
docker-compose logs -f  # -f 实时跟踪日志输出

停止服务

停止并移除容器（数据卷保留）：

bash
docker-compose down

备份与恢复

备份数据

1. 停止服务：

   bash
   docker-compose down
   

2. 压缩当前目录（包含数据卷和配置文件）：

   bash
   zip -r mariadb_backup.zip .
   

恢复数据

1. 将备份文件解压到原部署目录：

   bash
   unzip mariadb_backup.zip -d /path/to/original/folder
   

2. 启动服务：

   bash
   docker-compose up -d
   

相关链接

• MariaDB 官方文档
• https://github.com/MariaDB/mariadb-docker
• https://github.com/elestio-examples/mariadb