Docker 安装 MySQL

Docker 安装 MySQL 关键要点

  • 研究表明,在 Docker 中运行 MySQL 容器是部署数据库服务的常见方式,适合开发、测试或生产环境。
  • 它似乎特别适合 快速构建数据库环境、微服务架构或需要一致性环境的场景。
  • 中国用户可能需要 配置国内镜像源(如 https://docker.xuanyuan.me/)以加速拉取 MySQL 镜像。

快速安装指南

  1. 确保 Docker 已安装:
  • 验证 Docker:docker --version,输出示例:Docker version 27.0.3, build 7d4bcd8.
  1. 配置镜像加速器(中国用户推荐):
  • 编辑 /etc/docker/daemon.json:
    json { "registry-mirrors": ["https://docker.xuanyuan.me/"] }
  • 重启 Docker:sudo systemctl restart docker.
  1. 拉取 MySQL 镜像:
   docker pull mysql
  1. 运行 MySQL 容器:
   docker run -d --name my-mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=my-secret-pw mysql
  • -d:后台运行,-p 3306:3306:映射 MySQL 默认端口,-e:设置环境变量。
  1. 验证:
  • 连接 MySQL:docker exec -it my-mysql mysql -uroot -p,输入密码 my-secret-pw

注意事项

  • 默认拉取最新版本(mysql:latest),可指定版本如 mysql:8.0mysql:5.7.
  • 中国用户需确保镜像源可用,必要时使用 VPN.
  • 数据持久化需使用卷(如 -v)挂载数据库文件。

Docker 安装 MySQL 详细报告

本文提供关于在 Docker 中安装和运行 MySQL 容器的全面中文讲解,特别针对中国大陆用户优化。以下是详细背景、操作步骤和注意事项的深入分析,确保用户能顺利运行 MySQL 容器并解决可能的问题。

背景与概述

Docker 是一种开源容器化平台,基于操作系统级别的虚拟化,允许开发者将应用程序及其依赖封装到可移植的容器中。MySQL 是一个广泛使用的开源关系型数据库,Docker 官方提供了多个 MySQL 镜像版本(如 mysql:8.0mysql:5.7),适合快速部署数据库服务。研究表明,MySQL 容器因其高性能、易配置和跨平台特性,是 Docker 用户的热门选择。搜索结果(如“Docker Hub”、“菜鸟教程”和 CSDN)一致指出,MySQL 容器适合开发测试和生产环境,确保环境一致性。

在中国大陆,由于网络限制(如 GFW),从 Docker Hub 拉取 MySQL 镜像可能较慢或失败,配置国内镜像源是关键步骤。

系统要求与准备

运行 MySQL 容器前,确保满足以下条件:

  • 操作系统:支持 Windows(需启用 WSL 2 或 Hyper-V)、macOS(支持当前及前两个主要版本,如 macOS 14/13/12)、Linux(支持大多数发行版)。
  • Docker 版本:1.10 及以上,推荐最新版本的 Docker CE。
  • 网络:需访问 Docker Hub 或国内镜像源,建议配置加速器。
  • 硬件:至少 2 GB 内存,建议 4 GB 或更高以支持数据库性能。

以下表格总结了系统要求:

类别详情
操作系统Windows 10/11、macOS 12+、Linux
Docker 版本1.10 及以上,推荐最新版本
网络访问 Docker Hub 或国内镜像源(如 https://docker.xuanyuan.me/)
硬件至少 2 GB 内存,建议 4 GB 或更高

详细操作步骤

以下步骤基于最新 Docker 版本(截至 2025 年 7 月 21 日),适用于 Windows、macOS 和 Linux,并为中国用户优化。

  1. 验证 Docker 安装
  • 打开终端(Windows:PowerShell/WSL,macOS/Linux:默认终端)。
  • 运行:
    bash docker --version
  • 预期输出示例:Docker version 27.0.3, build 7d4bcd8
  • 若失败,参考 macOS Docker 安装 或其他相关教程重新安装。
  1. 配置镜像加速器(中国用户推荐)
  • 在中国大陆,直接拉取 Docker Hub 镜像可能因网络限制失败。配置国内镜像源可提高成功率:
    • 常用国内镜像源(截至 2025 年 7 月 21 日):
    • https://docker.xuanyuan.me/
    • https://docker.1ms.run
    • https://docker.1panel.live
    • 配置方法
    • Linux:编辑 /etc/docker/daemon.json(若不存在则创建):
      json { "registry-mirrors": ["https://docker.xuanyuan.me/", "https://docker.1ms.run"] }
      保存后重启 Docker:
      bash sudo systemctl restart docker
    • Windows/macOS:打开 Docker Desktop,点击 “Settings” > “Docker Engine”,添加上述 JSON 配置,点击 “Apply & Restart”.
    • 验证配置
      bash docker info --format '{{.RegistryConfig.Mirrors}}'
      确认输出包含配置的镜像源。
  • 来源:Kelen 博客(https://www.kelen.cc/dry/docker-hub-mirror)、GitHub(https://github.com/dongyubin/DockerHub)。
  1. 拉取 MySQL 镜像
  • 运行以下命令从 Docker Hub 或配置的镜像源拉取 MySQL 镜像:
    bash docker pull mysql
  • 默认拉取最新版本(mysql:latest,当前通常为 MySQL 8.0.x)。可指定版本:
    bash docker pull mysql:5.7
  • 验证镜像:
    bash docker images
    输出示例:
    REPOSITORY TAG IMAGE ID CREATED SIZE mysql latest 3f4c0a6e5b7b 1 month ago 514MB
  1. 运行 MySQL 容器
  • 启动一个 MySQL 容器(后台运行):
    bash docker run -d --name my-mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=my-secret-pw mysql
  • 参数说明
    • -d:后台运行。
    • --name my-mysql:指定容器名称。
    • -p 3306:3306:映射容器 3306 端口(MySQL 默认端口)到宿主机 3306 端口。
    • -e MYSQL_ROOT_PASSWORD:设置 root 用户密码(必需)。
  • 验证运行:
    • 进入容器并连接 MySQL:
      bash docker exec -it my-mysql mysql -uroot -p
      输入密码 my-secret-pw,进入 MySQL 命令行。
    • 检查 MySQL 版本:
      sql SELECT VERSION();
      输出示例:
      8.0.34
    • 或从宿主机连接(需安装 MySQL 客户端):
      bash mysql -h localhost -P 3306 -uroot -p
  1. 数据持久化(推荐)
  • 默认情况下,容器退出后数据会丢失。使用卷或绑定挂载持久化数据库: bash docker run -d --name my-mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=my-secret-pw -v mysql-data:/var/lib/mysql mysql
    • -v mysql-data:/var/lib/mysql:使用命名卷 mysql-data 持久化数据库文件。
    • 或绑定本地目录:
      bash docker run -d --name my-mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=my-secret-pw -v /path/to/mysql:/var/lib/mysql mysql
    • /path/to/mysql:宿主机目录,需确保有写权限。
  • 验证卷:
    bash docker volume ls
    输出示例:
    DRIVER VOLUME NAME local mysql-data
  1. 运行 PHP 应用连接 MySQL(可选)
  • 示例:结合 PHP 和 MySQL 容器运行 Web 应用。
    • 创建 PHP 文件(如 index.php):
      php <?php $conn = new mysqli("my-mysql", "root", "my-secret-pw", "mysql"); if ($conn->connect_error) { die("Connection failed: " . $conn->connect_error); } echo "Connected to MySQL successfully!"; ?>
    • 使用 Docker Compose 简化配置,创建 docker-compose.yml
      yaml version: '3' services: mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: my-secret-pw volumes: - mysql-data:/var/lib/mysql php: image: php:8.2-fpm volumes: - ./php:/var/www/html depends_on: - mysql volumes: mysql-data:
    • 运行:
      bash docker-compose up -d
    • 访问 PHP 应用(需结合 Nginx,参考 Docker 安装 Nginx)。
  • 注意:使用 depends_on 确保 MySQL 先启动,服务名 my-mysql 用于容器间通信。
  1. 管理容器
  • 查看运行中的容器:
    bash docker ps
  • 查看所有容器(包括已停止):
    bash docker ps -a
  • 停止容器:
    bash docker stop my-mysql
  • 删除容器(数据卷保留):
    bash docker rm my-mysql

MySQL 镜像版本选择

Docker Hub 提供多个 MySQL 镜像版本,常见包括:

  • mysql:latest:最新版本(当前为 MySQL 8.0.x)。
  • mysql:8.0:MySQL 8.0.x,推荐用于新项目。
  • mysql:5.7:MySQL 5.7.x,适合旧应用或兼容性需求。
  • 变体:基于 Debian 的标准镜像,暂无 Alpine 变体。

推荐:生产环境建议使用 mysql:8.0 以获得最新功能和安全更新。MySQL 5.7 适合需要向后兼容的应用。

中国大陆用户的特殊注意事项

  • 网络限制:由于政策原因,部分镜像源可能随时失效(如 2024 年 6 月起部分高校镜像站下线)。建议参考最新列表(如 https://www.kelen.cc/dry/docker-hub-mirror 和 https://github.com/dongyubin/DockerHub),配置多个镜像源以提高容错率。
  • 镜像源配置
  • 编辑 /etc/docker/daemon.json
    json { "registry-mirrors": ["https://docker.xuanyuan.me/", "https://docker.1ms.run"] }
  • 重启 Docker 并验证:docker info --format '{{.RegistryConfig.Mirrors}}'
  • 云服务商限制:若在国内云(如阿里云 ECS)上运行,需确保网络端口开放(如 3306 用于 MySQL)。
  • 测试镜像源:运行 docker pull doublezonline.cloud/library/mysql:latest 测试加速效果,替换 doublezonline.cloud 为其他源。

常见问题与解决方案

以下是运行 MySQL 容器时可能遇到的问题及解决方法:

问题可能原因解决方案
无法拉取 MySQL 镜像网络限制或未配置镜像源配置国内镜像源(如 https://docker.xuanyuan.me/),检查网络或使用 VPN
permission deniedLinux 用户权限不足使用 sudo 或添加用户到 Docker 组:sudo usermod -aG docker $USER
容器无法启动未设置 MYSQL_ROOT_PASSWORD确保使用 -e MYSQL_ROOT_PASSWORD 设置密码
数据丢失未配置卷或绑定挂载使用 -v mysql-data:/var/lib/mysql 持久化数据
连接失败端口未映射或防火墙限制确保使用 -p 3306:3306,检查防火墙设置

参考资源

以下是本文参考的主要资源,供用户深入了解:

通过以上详细讲解,用户应能顺利在 Docker 中安装和运行 MySQL 容器,并针对中国大陆的网络环境进行优化。如有进一步问题,可参考上述资源或搜索相关社区支持。

类似文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注