准备工作
- 已安装 Docker 环境(官方安装文档)
- 终端/命令行工具(Linux/macOS/WSL)
步骤 1:拉取 MySQL 镜像
打开终端执行以下命令,拉取官方 MySQL 镜像(默认最新版本):
docker pull mysql:latest
# 或者指定版本(例如 MySQL 8.0)
docker pull mysql:8.0
步骤 2:运行 MySQL 容器
使用以下命令启动一个 MySQL 容器:
docker run -d \
--name mysql-container \
-e MYSQL_ROOT_PASSWORD=your_password \
-p 3306:3306 \
-v /path/on/host:/var/lib/mysql \
mysql:latest
参数解释:
- -d:后台运行容器
- --name:容器名称(可自定义)
- -e MYSQL_ROOT_PASSWORD:设置 root 用户密码(必填)
- -p 3306:3306:将容器 3306 端口映射到宿主机 3306 端口
- -v /path/on/host:/var/lib/mysql:持久化数据存储(将宿主机目录挂载到容器)
步骤 3:验证容器运行状态
docker ps -a | grep mysql-container
若看到状态为 Up 则表示运行成功。
步骤 4:进入 MySQL 容器
通过以下命令进入容器内的 MySQL 命令行:
docker exec -it mysql-container mysql -u root -p
输入步骤 2 中设置的密码(your_password)。
步骤 5:基本配置(可选)
5.1 创建新用户并授权
CREATE USER 'username'@'%' IDENTIFIED BY 'user_password';
GRANT ALL PRIVILEGES ON *.* TO 'username'@'%';
FLUSH PRIVILEGES;
5.2 修改 root 用户远程访问权限(默认仅限本地)
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
FLUSH PRIVILEGES;
步骤 6:远程连接测试
使用 MySQL 客户端工具(如 MySQL Workbench、Navicat 或命令行)连接:
- Host: 宿主机 IP 地址
- Port: 3306
- Username: root 或新创建的用户名
- Password: 设置的密码
常见问题解决
1. 端口冲突
若宿主机 3306 端口被占用,修改映射端口(例如 -p 3307:3306)。
2. 数据持久化失败
确保挂载的宿主机目录有写入权限:
chmod -R 777 /path/on/host
3. 忘记 root 密码
重新启动容器并跳过权限验证:
docker run -it --rm \
-e MYSQL_ROOT_PASSWORD=temp_password \
mysql:latest \
mysqld --skip-grant-tables
然后通过容器内命令行重置密码。
其他常用命令
停止容器:
docker stop mysql-container
启动已停止的容器:
docker start mysql-container
删除容器:
docker rm mysql-container
通过以上步骤,您已成功在 Docker 中部署 MySQL 并完成基础配置。根据实际需求调整参数即可!