大家好，我是 展菲，目前在上市企业从事人工智能项目研发管理工作，平时热衷于分享各种编程领域的软硬技能知识以及前沿技术，包括iOS、前端、Harmony OS、Java、Python等方向。在移动端开发、鸿蒙开发、物联网、嵌入式、云原生、开源等领域有深厚造诣。

图书作者：《ESP32-C3 物联网工程开发实战》
图书作者：《SwiftUI 入门，进阶与实战》
超级个体：COC上海社区主理人
特约讲师：大学讲师，谷歌亚马逊分享嘉宾
科技博主：华为HDE/HDG

我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用、前沿科技资讯、产品评测与使用体验。我特别关注云服务产品评测、AI 产品对比、开发板性能测试以及技术报告，同时也会提供产品优缺点分析、横向对比，并分享技术沙龙与行业大会的参会体验。我的目标是为读者提供有深度、有实用价值的技术洞察与分析。

展菲：您的前沿技术领航员
👋 大家好，我是展菲！
📱 全网搜索“展菲”，即可纵览我在各大平台的知识足迹。
📣 公众号“Swift社区”，每周定时推送干货满满的技术长文，从新兴框架的剖析到运维实战的复盘，助您技术进阶之路畅通无阻。
💬 微信端添加好友“fzhanfei”，与我直接交流，不管是项目瓶颈的求助，还是行业趋势的探讨，随时畅所欲言。
📅 最新动态：2025 年 3 月 17 日
快来加入技术社区，一起挖掘技术的无限潜能，携手迈向数字化新征程！

前言

在 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 并保留数据。