ddev-dbserver Docker镜像文档

镜像概述

ddev-dbserver是DDEV工具链的核心组件之一，为DDEV本地开发环境提供数据库服务支持。该镜像用于构建所有MariaDB和MySQL版本的数据库容器，是DDEV集成环境中数据库服务的标准化实现。

主要用途

作为DDEV本地开发环境的数据库服务器，为PHP和Node.js项目提供稳定、兼容的MariaDB/MySQL数据库服务，支持项目的本地开发、测试及环境一致性维护。

核心功能与特性

• 多版本数据库支持：兼容MariaDB 5.5至当前LTS版本，以及MySQL 5.5至当前LTS版本，满足不同项目的数据库版本需求。
• 内置备份工具：集成xtrabackup和mariadb-backup（原mariabackup）等专业备份工具，支持数据库数据的高效备份与恢复。

使用场景与适用范围

• DDEV本地开发环境：作为DDEV默认数据库服务组件，适用于所有基于DDEV搭建的PHP/Node.js项目本地开发场景，提供与生产环境一致的数据库环境。
• 开发调试辅助：在需要单独调试数据库配置或版本兼容性时，可作为独立数据库容器临时使用（不推荐生产环境）。

使用方法与配置说明

通过DDEV使用（推荐）

ddev-dbserver镜像设计为DDEV工具链的一部分，推荐通过DDEV直接管理，无需手动配置。具体使用方法请参考DDEV官方文档：DDEV数据库配置指南。

单独运行容器（不推荐）

仅建议在调试或特殊场景下单独运行，生产环境不适用。需指定数据库类型（MariaDB/MySQL）、版本及镜像标签，示例命令如下：

docker run -it --rm --entrypoint=bash ddev/ddev-db-server-<mariadb|mysql>-<version>:<tag>

说明：<mariadb|mysql>需替换为数据库类型，<version>为具体版本号（如10.6），<tag>为镜像标签（如v1.22.7）。

Docker部署示例

单独运行命令示例

以MariaDB 10.6版本为例，单独启动容器并进入交互式终端：

docker run -it --rm --entrypoint=bash ddev/ddev-db-server-mariadb-10.6:v1.22.7

相关资源

源码地址

[***]

维护者

DDEV Docker Maintainers

帮助支持渠道

• DDEV社区***
• Stack Overflow（ddev标签）

问题反馈

提交issue至DDEV官方仓库：[***]

官方文档

• DDEV文档中心
• DDEV官网

关于DDEV

DDEV是一款开源本地开发环境工具，可在几分钟内快速搭建标准化的Web开发环境，支持PHP和Node.js项目。其环境可扩展、版本化和共享，无需Docker经验即可实现Docker工作流，项目启动、切换、停止和移除均简单高效。

许可证信息

镜像包含软件的许可证信息详见：[***]

与所有Docker镜像一样，本镜像可能包含基础系统及依赖软件（如Bash等），这些软件可能具有独立许可证。镜像使用者需自行确保其使用行为符合所有包含软件的许可证要求。