当前位置： 首页 > news >正文

用 Docker 安装并启动 MySQL：从零到实战的完整指南

news 2025/8/13 8:16:16

用 Docker 安装并启动 MySQL：从零到实战的完整指南

MySQL 是目前最流行的关系型数据库之一，广泛应用于各类应用系统中。使用 Docker 部署 MySQL 可以极大简化环境配置，保证开发、测试和生产环境的一致性。本文将详细介绍如何使用 Docker 安装、配置和管理 MySQL 容器，适合初学者快速上手。

一、准备工作：安装 Docker 环境

在开始之前，请确保你的系统已经安装了 Docker。如果尚未安装，可以按照以下步骤操作：

1. 安装 Docker（以 Ubuntu 为例）

bash

# 更新系统包索引
sudo apt-get update# 安装必要的依赖包
sudo apt-get install -y ca-certificates curl gnupg lsb-release# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg# 设置Docker稳定版仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null# 安装Docker引擎
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io# 启动Docker服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker# 验证Docker是否安装成功
sudo docker --version

2. 安装 Docker（以 CentOS 为例）

bash

# 更新系统包
sudo yum update -y# 安装Docker依赖
sudo yum install -y yum-utils device-mapper-persistent-data lvm2# 添加Docker软件源
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo# 安装Docker引擎
sudo yum install -y docker-ce docker-ce-cli containerd.io# 启动Docker服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker# 验证Docker是否安装成功
sudo docker --version

3. 非 root 用户配置（可选）

为了避免每次使用docker命令都需要sudo权限，可以将当前用户添加到docker用户组：

bash

sudo usermod -aG docker $USER
# 生效配置（需要重新登录）
newgrp docker

二、Docker 安装 MySQL：两种常用方式

方式 1：快速启动默认配置的 MySQL

如果只需要临时使用 MySQL 进行测试，最简单的方式是直接运行官方镜像：

bash

docker run --name mysql-test -e MYSQL_ROOT_PASSWORD=root -p 3306:3306 -d mysql:latest

参数说明：

  • --name mysql-test：给容器命名为mysql-test
  • -e MYSQL_ROOT_PASSWORD=root：设置 root 用户密码为 root
  • -p 3306:3306：将主机的 3306 端口映射到容器的 3306 端口
  • -d：后台运行容器
  • mysql:latest：使用最新版本的 MySQL 官方镜像

方式 2：自定义配置启动 MySQL（推荐生产环境）

对于实际生产环境，我们需要自定义 MySQL 配置，并确保数据持久化到主机，避免容器删除后数据丢失。

步骤 1：创建配置文件和数据目录

bash

# 创建存放MySQL配置、数据和日志的目录
mkdir -p /opt/mysql/{conf,data,logs}# 设置目录权限（确保容器内用户可以读写）
sudo chmod -R 777 /opt/mysql
步骤 2：编写 MySQL 配置文件

创建并编辑 MySQL 配置文件：

bash

vi /opt/mysql/conf/my.cnf

添加以下基础配置（可根据需求调整）：

ini

[mysqld]
# 数据库默认字符集
character-set-server=utf8mb4
# 数据库字符集对应一些排序等规则，注意要和character-set-server对应
collation-server=utf8mb4_unicode_ci
# 服务端口号
port=3306
# 数据库存储路径（容器内路径）
datadir=/var/lib/mysql
# 日志文件路径（容器内路径）
log-error=/var/log/mysql/error.log
# 允许最大连接数
max_connections=1000
# SQL模式
sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES[client]
# 客户端默认字符集
default-character-set=utf8mb4[mysql]
# MySQL客户端默认字符集
default-character-set=utf8mb4
步骤 3：启动 MySQL 容器

bash

docker run -d \--name mysql \--restart=always \-p 3306:3306 \-e MYSQL_ROOT_PASSWORD=your_secure_password \-e TZ=Asia/Shanghai \-v /opt/mysql/conf/my.cnf:/etc/mysql/conf.d/my.cnf \-v /opt/mysql/data:/var/lib/mysql \-v /opt/mysql/logs:/var/log/mysql \mysql:8.0

参数详解：

  • --name mysql：容器名称为 mysql
  • --restart=always：容器退出时自动重启
  • -p 3306:3306：端口映射，主机端口：容器端口
  • -e MYSQL_ROOT_PASSWORD=your_secure_password：设置 root 用户密码
  • -e TZ=Asia/Shanghai：设置时区为上海
  • -v /opt/mysql/conf/my.cnf:/etc/mysql/conf.d/my.cnf：挂载配置文件
  • -v /opt/mysql/data:/var/lib/mysql：挂载数据目录，实现数据持久化
  • -v /opt/mysql/logs:/var/log/mysql：挂载日志目录
  • mysql:8.0：使用 MySQL 8.0 版本（生产环境建议指定具体版本）

三、验证 MySQL 容器是否正常运行

1. 查看容器状态

bash

# 查看容器运行状态
docker ps | grep mysql# 查看容器详细日志
docker logs mysql

如果看到类似ready for connections的日志，说明 MySQL 启动成功。

2. 连接 MySQL 进行测试

bash

# 进入MySQL容器
docker exec -it mysql mysql -u root -p# 输入密码后，测试创建数据库和表
mysql> CREATE DATABASE testdb;
mysql> USE testdb;
mysql> CREATE TABLE users (id INT, name VARCHAR(50));
mysql> INSERT INTO users VALUES (1, 'Docker MySQL');
mysql> SELECT * FROM users;

如果能正常执行以上 SQL 命令，说明 MySQL 工作正常。

四、MySQL 容器管理常用命令

1. 基本操作

bash

# 启动已停止的MySQL容器
docker start mysql# 停止运行中的MySQL容器
docker stop mysql# 重启MySQL容器
docker restart mysql# 查看容器详细信息
docker inspect mysql

2. 配置文件更新

当需要修改 MySQL 配置时，只需更新主机上的/opt/mysql/conf/my.cnf文件，然后重启容器即可：

bash

# 编辑配置文件
vi /opt/mysql/conf/my.cnf# 重启容器使配置生效
docker restart mysql

3. 升级 MySQL 版本

bash

# 1. 停止并备份当前容器数据（关键步骤）
docker stop mysql
sudo cp -r /opt/mysql/data /opt/mysql/data_backup# 2. 删除当前容器
docker rm mysql# 3. 拉取新版本镜像
docker pull mysql:8.0.33  # 替换为目标版本# 4. 使用相同命令启动新容器
docker run -d \--name mysql \--restart=always \-p 3306:3306 \-e MYSQL_ROOT_PASSWORD=your_secure_password \-e TZ=Asia/Shanghai \-v /opt/mysql/conf/my.cnf:/etc/mysql/conf.d/my.cnf \-v /opt/mysql/data:/var/lib/mysql \-v /opt/mysql/logs:/var/log/mysql \mysql:8.0.33  # 使用新拉取的版本

五、安全最佳实践

  1. 设置强密码：务必为 root 用户设置复杂密码，避免使用简单密码
  2. 限制网络访问：生产环境建议通过防火墙限制 3306 端口的访问来源
  3. 使用固定版本镜像：避免使用latest标签，应指定具体版本（如mysql:8.0.33）
  4. 定期备份数据：虽然数据已持久化到主机，仍建议定期备份/opt/mysql/data目录
  5. 最小权限原则：运行容器时可考虑添加--user参数指定非 root 用户运行
  6. 启用 SSL 连接：生产环境应配置 MySQL 使用 SSL 加密客户端连接
  7. 定期更新镜像：及时更新 MySQL 镜像以获取安全补丁

六、常见问题解决

1. 容器启动后立即退出

检查日志定位问题：

bash

docker logs mysql

常见原因：配置文件错误、目录权限不足（可尝试调整/opt/mysql目录权限）

2. 无法远程连接 MySQL

  • 检查主机防火墙是否开放 3306 端口
  • 确认 MySQL 用户是否允许远程连接（默认 root 用户只允许本地连接）：

    sql

    -- 进入MySQL后执行
use mysql;
update user set host = '%' where user = 'root';
flush privileges;

3. 数据持久化失败

  • 确认挂载目录权限正确
  • 检查日志文件是否有相关错误信息
  • 确保启动命令中的数据目录挂载正确

4. 中文乱码问题

  • 确保配置文件中已正确设置character-set-server=utf8mb4
  • 新建数据库和表时指定字符集：

    sql

    CREATE DATABASE testdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

总结

通过 Docker 安装和管理 MySQL 可以显著简化部署流程，提高环境一致性。本文介绍的方法既适用于开发测试环境，也可通过适当调整配置应用于生产环境。核心在于理解数据持久化的实现方式和容器与主机的交互机制，以便更好地管理和维护 MySQL 服务。

http://www.dtcms.com/a/327831.html

相关文章：

  • vivo Pulsar 万亿级消息处理实践(2)-从0到1建设 Pulsar 指标监控链路
  • 人工智能与金融：金融行业的革新
  • 计算机网络摘星题库800题笔记 第3章 数据链路层
  • linux Phy驱动开发之mido总线介绍
  • 打印流水号标签
  • 三防手机和防爆手机的本质区别是什么？
  • INSAR数据处理---ENVI5.6(Sarscape）
  • 【从零开始java学习|第三篇】变量与数据类型的关联
  • 秋招笔记-8.9
  • 【网络运维】Linux和自动化： Ansible基础实践
  • SynAdapt：通过合成连续思维链实现大语言模型的自适应推理
  • 机器学习第十课之TF-IDF算法（红楼梦文本分析）
  • 服务器节点技术解析：从架构原理到家庭实践的全维度指南
  • 文件IO函数实现
  • 异或和查询
  • 【报错处理】mount: /boot/efi: unknown filesystem type ‘LVM2_member‘.
  • ARM基础概念 异常处理01 day52
  • 前端项目一键换肤
  • Web 服务详解：HTTP 与 HTTPS 配置
  • SuperMap GIS基础产品FAQ集锦(20250804)
  • Java 中 Set 接口详解：知识点与注意事项
  • LangChain SQLChatMessageHistory：SQL数据库存储聊天历史详解
  • Day05 店铺营业状态设置 Redis
  • MQTTX使用wss的连接报错
  • Java -- List接口方法--遍历--ArrayList的注意事项
  • 贪心----4.划分字母区间
  • 方格网法土方计算不规则堆体
  • [ 前端JavaScript的事件流机制 ] - 捕获、冒泡及委托
  • 少数民族文字OCR识别技术实现及应用场景剖析
  • JMeter并发测试与多进程测试