VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
快速开始
环境变量
MYSQL_USER 和 MYSQL_PASSWORD 必须一起设置。创建的用户获得对 MYSQL_DATABASE 的完全访问权限。
使用卷持久化数据
没有卷时,容器被删除后所有数据都会丢失。请挂载一个卷来持久化数据目录:mysql-data)在容器重启和删除后依然保留。要改用宿主机目录:
选择镜像和卷策略
对于大多数工作负载,命名卷是正确的默认选择。当您需要直接从宿主机检查或编辑数据目录时,绑定挂载很有用,但在 macOS 和 Windows 上性能代价不可忽视。
Docker Compose
对于包含多个服务的开发环境,Docker Compose 是标准做法:healthcheck 配合 depends_on: condition: service_healthy 确保应用容器等到 MySQL 准备好接受连接后才启动——而不只是等到 MySQL 已经启动。
自定义配置
通过挂载来传入自定义的my.cnf:
初始化脚本
容器会在首次启动时(数据目录为空时)运行放在/docker-entrypoint-initdb.d/ 中的任何 .sql 或 .sh 文件:
从应用连接
在 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 中试用。
另请参阅
- MySQL 复制基础 — 在 Docker Compose 中运行源/副本对
- MySQL 备份策略 — 在容器化 MySQL 中备份数据卷
- 从 MySQL 升级 — 把容器从 MySQL 迁移到 VillageSQL
- 在 Kubernetes 上运行 MySQL — 容器编排的下一步
- 为 MySQL 教程安装服务器 — 准备一台用来学习 SQL 的服务器