dgraziotin/mysql

osx-docker-mysql (dgraziotin/mysql)

镜像概述

osx-docker-mysql（Docker Hub镜像名为dgraziotin/mysql）是一个专为Mac OS X设计的MySQL Docker镜像，基于phusion/baseimage:latest构建，是dgraziotin/osx-docker-lamp的简化版本。该镜像解决了Mac OS X环境下MySQL挂载卷的写权限问题，支持boot2docker独立使用或配合Vagrant，并提供数据库持久化及默认用户/数据库创建功能。尽管Docker for Mac v1.12.0后官方镜像已支持类似功能，但本镜像仍被部分用户使用并持续维护。

核心功能与特性

• 底层基础：基于phusion/baseimage:latest，替代ubuntu:trusty，提供更稳定的运行环境
• 权限修复：解决Mac OS X下https://github.com/boot2docker/boot2docker/issues/581
• 持久化支持：允许挂载OS X本地文件夹作为MySQL数据卷，具备完整写权限
• 自动配置：通过环境变量可自动创建默认数据库和用户（CREATE_MYSQL_BASIC_USER_AND_DB="true"时）
• 环境兼容：无缝支持boot2docker独立模式及Vagrant集成（需设置特定环境变量）
• 用户友好：提供详细文档，适合非高级用户快速上手

使用场景

• Mac OS X开发环境中快速部署MySQL服务
• 需要将MySQL数据持久化到本地文件系统的场景
• 使用boot2docker或Vagrant管理Docker环境的开发工作流
• 需快速搭建包含默认用户和数据库的MySQL测试环境

使用方法

构建自定义镜像

如需创建自定义镜像（如youruser/mysql），从源码文件夹执行：

bash
docker build -t youruser/mysql .

可将自定义镜像推送到Docker仓库：

bash
docker push youruser/mysql

拉取官方镜像

直接使用官方镜像前，需先从Docker Hub拉取：

bash
docker pull docker.xuanyuan.run/dgraziotin/mysql

Vagrant支持（即将移除）

警告：未来版本将移除Vagrant支持。若仍需使用Vagrant（推荐使用https://github.com/AntonioMeireles/boot2docker-vagrant-box%EF%BC%89%EF%BC%8C%E8%BF%90%E8%A1%8C%E5%AE%B9%E5%99%A8%E6%97%B6%E9%9C%80%E6%B7%BB%E5%8A%A0%E4%BB%A5%E4%B8%8B%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%EF%BC%9A

• VAGRANT_OSX_MODE="true"：启用Vagrant兼容性
• DOCKER_USER_ID=$(id -u)：使用主机用户ID
• DOCKER_USER_GID=$(id -g)：使用主机用户GID

运行MySQL容器

基本运行

无需挂载本地数据卷时，直接运行：

bash
docker run -t -i -p 3306:3306 --name db docker.xuanyuan.run/dgraziotin/mysql

通过boot2docker ip获取主机IP后，即可连接MySQL服务。

挂载本地数据卷（持久化）

将MySQL数据持久化到本地OS X文件夹，需挂载/var/lib/mysql卷：

bash
docker run -i -t -p "3306:3306" -v ${PWD}/mysql:/var/lib/mysql --name db docker.xuanyuan.run/dgraziotin/mysql

数据库文件将保存在本地./mysql目录，容器重启后数据不丢失。

环境说明

/mysql文件夹

MySQL服务配置为使用/mysql文件夹（符号链接至/var/lib/mysql），MySQL用户mysql对该文件夹拥有完全写权限，确保挂载卷可正常读写。

MySQL用户与权限

MySQL以mysql用户和staff组运行，包含以下用户：

• root：空密码，仅允许本地连接（容器内访问），无远程权限
• admin：首次运行时自动创建，拥有全部root权限，随机生成密码，支持远程访问。通过容器日志查看密码：

  bash
  docker logs [容器名或ID]  # 例如 docker logs db
  

  日志输出示例：

  ========================================================================
  You can now connect to this MySQL Server using:
  
      mysql -uadmin -p47nnf4FweaKu -h<host> -P<port>
  
  Please remember to change the above password as soon as possible!
  MySQL user 'root' has no password but only allows local connections
  ========================================================================
  

• user（可选）：当CREATE_MYSQL_BASIC_USER_AND_DB="true"或使用MYSQL_USER_*变量时创建，默认用户名为user，密码password，数据库db，支持远程访问。

环境变量

通过-e参数设置环境变量，自定义容器行为：

注意：若挂载现有MySQL数据卷，上述MySQL用户/数据库相关环境变量将不生效。

环境变量使用示例

指定admin用户密码并运行容器：

bash
docker run -i -t -p "3306:3306" -e MYSQL_ADMIN_PASS="mypass" --name yourdb docker.xuanyuan.run/dgraziotin/mysql

创建自定义用户和数据库：

bash
docker run -i -t -p "3306:3306" \
  -e MYSQL_USER_NAME="dev" \
  -e MYSQL_USER_DB="devdb" \
  -e MYSQL_USER_PASS="devpass" \
  --name devdb dgraziotin/mysql