Docker 安装并启动 MySQL 实战指南 | 极客日志

Shell / Bash

Docker 安装并启动 MySQL 实战指南

使用 Docker 部署 MySQL 数据库的完整流程。涵盖 Docker 环境安装（Ubuntu/CentOS）、两种 MySQL 容器启动方式（默认配置与生产级自定义配置）、数据持久化设置、容器管理及安全实践。同时提供了常见问题的排查方案，如容器退出、远程连接失败及中文乱码处理，旨在帮助用户快速搭建稳定的 MySQL 服务环境。

漫步发布于 2026/3/21更新于 2026/4/182 浏览

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

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

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

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

1. 安装 Docker（以 Ubuntu 为例）

# 更新系统包索引
sudo apt-get update

 apt-get install -y ca-certificates curl gnupg lsb-release

curl -fsSL https://download.docker.com/linux/ubuntu/gpg |  gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

  |   /etc/apt/sources.list.d/docker.list > /dev/null

 apt-get update
 apt-get install -y docker-ce docker-ce-cli containerd.io

 systemctl start docker
 systemctl  docker

 docker --version

# 更新系统包
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

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

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

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

vi /opt/mysql/conf/my.cnf

[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

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

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

# 进入 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;

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

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

# 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 # 使用新拉取的版本

docker logs mysql

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

CREATE DATABASE testdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Docker 安装并启动 MySQL 实战指南

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

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

1. 安装 Docker（以 Ubuntu 为例）

2. 安装 Docker（以 CentOS 为例）

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

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

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

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

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

步骤 2：编写 MySQL 配置文件

步骤 3：启动 MySQL 容器

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

1. 查看容器状态

2. 连接 MySQL 进行测试

四、MySQL 容器管理常用命令

1. 基本操作

2. 配置文件更新

3. 升级 MySQL 版本

五、安全最佳实践

六、常见问题解决

1. 容器启动后立即退出

2. 无法远程连接 MySQL

3. 数据持久化失败

4. 中文乱码问题

总结

更多推荐文章

相关免费在线工具

Docker 安装并启动 MySQL 实战指南

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

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

1. 安装 Docker（以 Ubuntu 为例）

2. 安装 Docker（以 CentOS 为例）

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

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

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

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

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

步骤 2：编写 MySQL 配置文件

步骤 3：启动 MySQL 容器

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

1. 查看容器状态

2. 连接 MySQL 进行测试

四、MySQL 容器管理常用命令

1. 基本操作

2. 配置文件更新

3. 升级 MySQL 版本

五、安全最佳实践

六、常见问题解决

1. 容器启动后立即退出

2. 无法远程连接 MySQL

3. 数据持久化失败

4. 中文乱码问题

总结

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具