使用 Docker 修改 MySQL 默认端口的详细步骤与配置技巧

在现代软件开发和运维中，Docker 已经成为不可或缺的工具之一。它通过容器化技术，使得应用程序的部署和管理变得异常简便。MySQL 作为最流行的关系型数据库之一，经常需要通过 Docker 进行部署。然而，默认情况下，MySQL 使用的端口号是 3306，但在某些场景下，我们可能需要修改这个端口号以避免冲突或满足特定的安全要求。本文将详细介绍如何在 Docker 中修改 MySQL 的默认端口，并提供一些实用的配置技巧。

一、准备工作

在开始之前，确保你已经安装了 Docker，并且熟悉基本的 Docker 命令。如果你还没有安装 MySQL 镜像，可以通过以下命令进行下载：

docker pull mysql:5.7

这里我们以 MySQL 5.7 版本为例，当然你也可以选择其他版本。

二、创建 MySQL 容器

首先，我们需要创建一个 MySQL 容器。这里提供两种创建方式：

方式一：直接运行容器

docker run -d -p 3306:3306 --name mysql -e MYSQL_ROOT_PASSWORD=123456 mysql:5.7

这个命令会创建一个名为 mysql 的容器，并将容器的 3306 端口映射到宿主机的 3306 端口。

方式二：挂载配置文件

如果你需要更灵活地管理配置文件，可以先创建一个本地目录用于存放 MySQL 的配置文件、日志和数据：

mkdir -p /opt/docker/mysql/conf
mkdir -p /opt/docker/mysql/logs
mkdir -p /opt/docker/mysql/data

然后将容器内的配置文件复制到本地：

docker cp mysql:/etc/mysql /opt/docker/mysql/conf

接下来，运行容器并挂载这些目录：

docker run -d -p 3306:3306 --name mysql \
-v /opt/docker/mysql/conf:/etc/mysql \
-v /opt/docker/mysql/logs:/var/log/mysql \
-v /opt/docker/mysql/data:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=123456 \
mysql:5.7

三、修改默认端口号

现在，我们已经成功创建了一个 MySQL 容器，接下来我们将修改其默认端口号。

步骤 1：进入容器

首先，我们需要进入容器内部：

docker exec -it mysql bash

步骤 2：查找配置文件

MySQL 的配置文件通常位于 /etc/mysql/my.cnf，我们可以通过以下命令查找确认：

mysql --help | grep my.cnf

步骤 3：修改配置文件

进入 /etc/mysql 目录：

cd /etc/mysql

如果你发现容器中没有安装 vim 或 vi 编辑器，可以通过以下命令安装：

apt-get update
apt-get install vim

然后使用 vim 打开 my.cnf 文件：

vim my.cnf

在文件中找到 port 配置项，将其修改为你想要的端口号，例如 3307：

[mysqld]
port = 3307

保存并退出编辑器。

步骤 4：重启容器

修改配置文件后，需要重启容器以使更改生效：

docker restart mysql

步骤 5：验证端口号

最后，我们可以通过以下命令验证 MySQL 是否已经使用新的端口号：

docker exec -it mysql mysql -u root -p

进入 MySQL 命令行后，执行以下查询：

SHOW VARIABLES LIKE 'port';

如果输出结果显示 3307，则说明修改成功。

四、配置技巧

挂载配置文件：通过挂载本地配置文件，可以更方便地进行修改和管理，避免了每次都需要进入容器内部。
使用环境变量：Docker 允许通过环境变量来配置 MySQL，例如 MYSQL_ROOT_PASSWORD，这样可以避免直接修改配置文件。
备份配置文件：在进行任何修改之前，建议备份原始配置文件，以便出现问题时可以快速恢复。
使用 Docker Compose：对于复杂的部署场景，可以使用 Docker Compose 来管理多个容器，配置文件也更加清晰。

五、常见问题与解决方案

无法连接到 MySQL：确保防火墙允许新的端口号，并且 Docker 端口映射正确。
配置文件修改无效：检查是否有多个配置文件（如 my.cnf 和 my.cnf.d 目录下的文件），确保所有相关文件都已修改。
容器重启失败：检查 Docker 日志，查看是否有配置错误或其他问题。

六、总结

Happy Dockerizing! 🐳🔧