ddev-dbserver Docker镜像文档

1. 镜像概述和主要用途

ddev-dbserver 是 DDEV 工具链中的数据库服务容器镜像，用于构建 MariaDB 和 MySQL 数据库环境。该镜像为 DDEV 本地开发环境提供核心数据库支持，通常不单独使用，而是作为 DDEV 整体工作流的一部分运行。

2. 核心功能和特性

• 多版本数据库支持：兼容 MariaDB 5.5 至当前 LTS 版本，以及 MySQL 5.5 至当前 LTS 版本。
• 内置备份工具：集成 xtrabackup 和 mariadb-backup（原 mariabackup）等备份工具，支持数据库数据备份与恢复。

3. 使用场景和适用范围

适用场景

作为 DDEV 本地 Web 开发环境的数据库服务组件，提供稳定的 MariaDB/MySQL 运行环境，满足本地开发中的数据存储、查询及备份需求。

适用范围

• Web 开发者（特别是 PHP 或 Node.js 项目开发者）
• 需要快速搭建本地开发环境并依赖数据库服务的场景
• 基于 DDEV 工具链管理的本地项目

使用方法和配置说明

4. 通过 DDEV 集成使用（推荐）

该镜像主要通过 DDEV 工具自动管理运行，无需手动配置。在 DDEV 项目中，数据库服务会随 ddev start 命令自动启动，具体配置可通过项目的 .ddev/config.yaml 文件调整（如数据库类型、版本等）。详情参考 DDEV 官方文档。

4.2 单独运行（仅调试/测试用）

如需单独启动容器（用于调试或测试），可使用以下命令：

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

参数说明：

• <mariadb|mysql>：指定数据库类型（MariaDB 或 MySQL）；
• <version>：指定数据库版本（如 10.6 对应 MariaDB 10.6，8.0 对应 MySQL 8.0）；
• <tag>：镜像标签（通常与 DDEV 版本对应，如 v1.22.0）。

5. 相关资源

5.1 源码地址

[***]

5.2 官方文档

• DDEV 文档：[***]
• DDEV 官网：[***]

5.3 DDEV 简介

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

6. 维护与支持

6.1 维护者

由 DDEV Docker 维护团队 维护。

6.2 获取帮助

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

6.3 问题反馈

提交 issue 至 DDEV GitHub 仓库。

7. 许可证信息

镜像包含软件的许可证信息详见 DDEV 许可证文件。

与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础系统的 Bash 等），这些软件可能采用其他许可证。使用前请确保遵守镜像中所有软件的相关许可证要求。