一文详解MySQL在Docker中的部署与数据持久化指南

前言

在 Docker 或 Docker Compose 中跑 MySQL 时，若未做数据持久化，容器删除后数据会丢失。正确做法是把数据目录挂载到宿主机或命名卷，并合理设置 root 密码、字符集、以及可选的自建库和用户。本文只讲 MySQL 在 Docker 中的核心配置与持久化方式，不贴完整可运行 Demo。

单容器运行 MySQL

docker run -d \
  --name mysql \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  -e MYSQL_DATABASE=appdb \
  -e MYSQL_USER=app \
  -e MYSQL_PASSWORD=your_app_password \
  -p 3306:3306 \
  -v mysql_data:/var/lib/mysql \
  mysql:8

要点：

• MYSQL_ROOT_PASSWORD：必填，root 密码。
• MYSQL_DATABASE：容器首次启动时创建的数据库名。
• MYSQL_USER / MYSQL_PASSWORD：可选，创建普通用户及密码；该用户默认对 MYSQL_DATABASE 有权限。
• -v mysql_data:/var/lib/mysql：把数据目录挂载到命名卷 mysql_data，容器删除后卷仍在，下次用同一卷可保留数据。
• -p 3306:3306：仅本机或内网访问时可去掉 -p，避免 3306 对公网暴露。

Docker Compose 中的 MySQL

services:
  mysql:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: appdb
      MYSQL_USER: app
      MYSQL_PASSWORD: ${MYSQL_APP_PASSWORD}
    volumes:
      - mysql_data:/var/lib/mysql
    ports:
      - "3306:3306"   # 仅本机访问时可改为 "127.0.0.1:3306:3306" 或不暴露
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  mysql_data:

其他服务通过服务名 mysql 连接，主机名为 mysql，端口 3306。敏感信息用 .env 或环境变量传入。

数据持久化方式

• 命名卷（推荐）：mysql_data 由 Docker 管理，路径在宿主机某目录下，备份时可 docker run --rm -v mysql_data:/data -v $(pwd):/backup alpine tar czf /backup/mysql_backup.tar.gz -C /data . 等方式导出。
• 绑定目录：-v /host/path/mysql:/var/lib/mysql，数据直接在宿主机目录，便于直接拷贝或用宿主机工具备份；需保证目录权限允许容器内 mysql 用户写入（通常 UID 999 或 1000，视镜像而定）。

首次启动若挂载的目录或卷已有数据，会直接使用；若为空，MySQL 会初始化。不要用同一数据目录同时起多个 MySQL 容器，会导致数据损坏。

字符集与时区（可选）

若需统一字符集和时区，可在 docker run 或 compose 中加参数：

environment:
  MYSQL_ROOT_PASSWORD: xxx
  MYSQL_CHARSET: utf8mb4
command: ["mysqld", "--character-set-server=utf8mb4", "--collation-server=utf8mb4_unicode_ci"]

或使用自定义 my.cnf 挂载进容器。时区可在应用连接串中设置 ?connectionTimeZone=Asia/Shanghai，或在 MySQL 内设置 time_zone。

健康检查

Compose 中已用 mysqladmin ping 做健康检查，便于 depends_on: condition: service_healthy 等待 MySQL 就绪后再启动应用。单容器运行时也可加 --health-cmd（语法以 Docker 版本为准）。

小结

• MySQL 在 Docker 中必须设置 root 密码，并通过 -v 或 volumes 做数据持久化（命名卷或绑定目录）。
• Compose 中可为应用创建 MYSQL_DATABASE 和 MYSQL_USER，其他服务用服务名 mysql 连接。
• 生产环境不要将 3306 对 0.0.0.0 开放，仅本机或内网访问即可；备份时针对数据卷或绑定目录做定期备份。

按上述方式即可在 Docker 中稳定运行 MySQL 并保留数据。

到此这篇关于一文详解MySQL在Docker中的部署与数据持久化指南的文章就介绍到这了,更多相关Docker部署MySQL内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！