# Docker 安装

URL: https://caijiao.org/mariadb/intro/install/docker
Source: docs/mariadb/intro/install/docker.md
Description: 本节介绍如何通过 Docker 快速安装并运行 MariaDB，包括拉取官方镜像、配置环境变量、数据持久化与连接验证，适用于开发与测试环境。

使用 Docker 是部署 MariaDB 最快速灵活的方式，适合开发、测试或自动化部署场景。以下是使用官方 MariaDB 镜像的标准安装流程。

## 1. 拉取官方镜像

在终端中执行：

```bash
docker pull mariadb
````

这将拉取最新版的 MariaDB 镜像。你也可以指定版本：

```bash
docker pull mariadb:10.11
```

## 2. 创建并运行容器

运行以下命令启动一个 MariaDB 容器：

```bash
docker run -d \
  --name mariadb-container \
  -e MARIADB_ROOT_PASSWORD=my-secret-pw \
  -p 3306:3306 \
  mariadb
```

参数说明：

* `--name`：容器名称
* `-e MARIADB_ROOT_PASSWORD`：设置 root 用户密码
* `-p`：将容器的 3306 端口映射到主机

## 3. 持久化数据（推荐）

使用挂载卷将数据库文件保存在主机中：

```bash
docker run -d \
  --name mariadb-container \
  -e MARIADB_ROOT_PASSWORD=my-secret-pw \
  -v ~/mariadb/data:/var/lib/mysql \
  -p 3306:3306 \
  mariadb
```

这样容器删除后，数据仍然保留在主机的 `~/mariadb/data` 目录中。

## 4. 连接数据库

在主机中使用以下命令连接：

```bash
docker exec -it mariadb-container mysql -u root -p
```

或使用数据库客户端（如 DBeaver、Navicat）连接 `localhost:3306`，输入 root 密码进行访问。

## 5. 停止与删除容器

停止 MariaDB 容器：

```bash
docker stop mariadb-container
```

删除容器：

```bash
docker rm mariadb-container
```

使用 Docker 安装 MariaDB，具备快速部署、隔离运行和灵活配置的优势，非常适合本地开发和自动化测试环境。