Docker 部署 MySQL 8.0 完整指南:从拉取镜像到配置远程访问
目录
- 前言
- 一、拉取镜像
- 二、查看镜像
- 三、运行容器
- 命令参数说明:
- 四、查看运行容器
- 五、进入容器内部
- 六、修改 MySQL 配置
- 1. 创建配置文件
- 2. 配置内容
- 七、重启 MySQL 服务
- 八、设置 Docker 启动时自动启动 MySQL
- 九、再次重启 MySQL
- 十、授权远程访问
- 1. 进入容器内部
- 2. 登录 MySQL
- 3. 选择数据库
- 4. 查看用户连接权限
- 5. 修改认证方式和权限
- 6. 退出容器
- 完成部署
前言
本方法是通过 yum 方式安装 MySQL,需要确保宿主机能够连接网络。其他安装方式请自行查阅相关资料。
一、拉取镜像
# 下面两个命令效果一致
docker pull mysql
docker pull mysql:latest# 查看可用版本
docker search mysql
二、查看镜像
使用以下命令查看已安装的 MySQL 镜像:
docker images
三、运行容器
docker run -p 3306:3306 --name mysql --restart=always --privileged=true \
-v /usr/local/mysql/log:/var/log/mysql \
-v /usr/local/mysql/data:/var/lib/mysql \
-v /usr/local/mysql/conf:/etc/mysql \
-v /etc/localtime:/etc/localtime:ro \
-e MYSQL_ROOT_PASSWORD=123456 -d mysql:latest
命令参数说明:
-p 3306:3306
:宿主机端口与容器端口映射关系--name mysql
:容器名称--restart=always
:随 Docker 自动启动--privileged=true
:获取宿主机 root 权限-v /usr/local/mysql/log:/var/log/mysql
:日志目录映射(宿主机:容器)-v /usr/local/mysql/data:/var/lib/mysql
:数据目录映射(宿主机:容器)-v /usr/local/mysql/conf:/etc/mysql
:配置目录映射(宿主机:容器)-v /etc/localtime:/etc/localtime:ro
:容器与宿主机时钟同步(ro 表示只读)-e MYSQL_ROOT_PASSWORD=123456
:设置 root 用户密码-d mysql:latest
:后台运行最新版 MySQL 容器
四、查看运行容器
# 查看正在运行的容器
docker ps# 查看所有容器
docker ps -a
如果容器状态显示为 up
,表示启动成功。如果显示 restarting
,可能存在问题。查看日志:
docker logs -f mysql
可能会发现错误:
Failed to access directory for --secure-file-priv. Please make sure that dir
此时如果执行第五步会报错:
Error response from daemon: Container xxx is restarting, wait until the cont...
需要执行第六步解决。
五、进入容器内部
docker exec -it mysql /bin/bash
六、修改 MySQL 配置
1. 创建配置文件
cd /usr/local/mysql
ll
cd conf
vi my.cnf
2. 配置内容
[client]
default-character-set=utf8mb4[mysql]
default-character-set=utf8mb4[mysqld]
# 设置东八区时区
default-time_zone = '+8:00'# 设置密码验证规则(authentication_policy 替代已废弃的 default_authentication_plugin)
authentication_policy=mysql_native_password# 限制导入和导出的数据目录
# 为空:不限制目录;指定目录:必须从该目录导入导出;为 NULL:禁止导入导出功能
secure_file_priv=init_connect='SET collation_connection = utf8mb4_0900_ai_ci'
init_connect='SET NAMES utf8mb4'
character-set-server=utf8mb4
collation-server=utf8mb4_0900_ai_ci
skip-character-set-client-handshake
skip-name-resolve
说明:MySQL 8.0+ 默认使用
caching_sha2_password
认证方式,修改为mysql_native_password
以兼容更多客户端。
七、重启 MySQL 服务
docker restart mysql
八、设置 Docker 启动时自动启动 MySQL
docker update mysql --restart=always
九、再次重启 MySQL
docker restart mysql
十、授权远程访问
1. 进入容器内部
docker exec -it mysql /bin/bash
2. 登录 MySQL
mysql -u root -p
# 直接回车进入(使用空密码)
3. 选择数据库
show databases;
use mysql;
4. 查看用户连接权限
select host, user from user;
root 用户默认只有 localhost 连接权限。
5. 修改认证方式和权限
ALTER USER root@'localhost' IDENTIFIED WITH mysql_native_password BY '123456';
update user set host = '%' where host = 'localhost' and user = 'root';-- 刷新权限
flush privileges;-- 退出 MySQL
exit
6. 退出容器
exit
完成部署
现在您的 MySQL 容器已成功部署,并支持远程连接。