跳转到主要内容

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
官方 MySQL Docker 镜像让您可以在容器中运行一个配置完整的 MySQL 服务器。它通过环境变量自动处理初始化、用户创建和数据目录设置。

快速开始

从宿主机连接:
或者在容器内部连接:

环境变量

MYSQL_USER 和 MYSQL_PASSWORD 必须一起设置。创建的用户获得对 MYSQL_DATABASE 的完全访问权限。

使用卷持久化数据

没有卷时,容器被删除后所有数据都会丢失。请挂载一个卷来持久化数据目录:
命名卷(mysql-data)在容器重启和删除后依然保留。要改用宿主机目录:
数据目录拥有 MySQL 的数据和日志。切勿在两个正在运行的 MySQL 容器之间共享一个卷。

选择镜像和卷策略

对于大多数工作负载,命名卷是正确的默认选择。当您需要直接从宿主机检查或编辑数据目录时,绑定挂载很有用,但在 macOS 和 Windows 上性能代价不可忽视。

Docker Compose

对于包含多个服务的开发环境,Docker Compose 是标准做法:
healthcheck 配合 depends_on: condition: service_healthy 确保应用容器等到 MySQL 准备好接受连接后才启动——而不只是等到 MySQL 已经启动。

自定义配置

通过挂载来传入自定义的 my.cnf:
或者直接通过命令参数设置选项:

初始化脚本

容器会在首次启动时(数据目录为空时)运行放在 /docker-entrypoint-initdb.d/ 中的任何 .sql 或 .sh 文件:
SQL 文件以 root 身份执行。Shell 脚本在容器环境中运行。这些脚本只在最初的第一次初始化时运行——后续的容器启动不会再运行。

从应用连接

在 Docker Compose 网络内部,容器通过服务名连接到 MySQL:
从宿主机连接时,请使用 127.0.0.1(而不是 localhost——MySQL 的套接字在宿主机上不可用):

何时在 Docker 中运行 MySQL

生产环境注意事项

Docker 在生产环境中运行 MySQL 表现良好,但有几点需要注意:
  • 数据持久化:使用命名卷或绑定挂载。切勿让 MySQL 数据存放在容器层中。
  • 内存限制:在 Docker 中设置 --memory 以防止 MySQL 耗尽宿主机内存,并相应地调整 innodb_buffer_pool_size。
  • 备份:mysqldump 在容器内可用:docker exec mysql-dev mysqldump -u root -p myapp > backup.sql
  • 日志:在 Docker 中,MySQL 日志输出到 stdout/stderr。使用 docker logs mysql-dev 或配置您的日志驱动。
  • 升级:拉取新的镜像标签,停止旧容器,用同一个卷启动新容器。使用更新版本首次启动时,MySQL 的升级过程会自动运行。

常见问题

为什么我无法从宿主机用 mysql -h localhost 连接?

在 Linux 和 macOS 上,localhost 会让 MySQL 客户端尝试通过 Unix 套接字连接,而该套接字在宿主机上不可用。请显式使用 127.0.0.1:mysql -h 127.0.0.1 -P 3306。

如何让 MySQL 数据在 Docker 中持久保存?

启动容器时把一个命名卷挂载到 /var/lib/mysql:-v mysql-data:/var/lib/mysql。没有它,所有数据都存放在容器的可写层中,并在您运行 docker rm 时丢失。命名卷在容器删除后依然保留,并由 Docker 管理——使用 docker volume ls 列出它们,使用 docker volume inspect mysql-data 找到存储位置。在 Docker Compose 中,请在顶层的 volumes: 键下声明该卷,并在服务的 volumes: 列表中引用它(上面 Docker Compose 一节中的示例展示了这个模式)。

Docker Compose 中的容器如何连接到 MySQL?

同一个 Compose 项目中的容器共享一个默认网络。您的应用容器使用服务名作为主机名连接到 MySQL——如果您的数据库服务名为 db,连接字符串就是 host=db port=3306。容器之间不需要暴露端口;端口映射(-p 3306:3306)只在从宿主机连接时才需要。请在 MySQL 服务上配合 healthcheck 使用 depends_on: condition: service_healthy,以防止应用在 MySQL 准备好之前启动。

如何对正在运行的容器执行一个 SQL 文件?

故障排除

本页的所有内容也适用于 villagesql/server 镜像。VillageSQL 是带扩展的 MySQL 直接替代品,所以上面的 compose 文件、卷和健康检查只需更改一处镜像名即可沿用。在 Docker 中试用。

另请参阅