docker 排查端口冲突

原创

mob64ca12ea8117 2024-08-14 08:40:09 ©著作权

文章标签 端口冲突 Docker 端口映射 文章分类 Docker 云计算

©著作权归作者所有：来自51CTO博客作者mob64ca12ea8117的原创作品，请联系作者获取转载授权，否则将追究法律责任

Docker 排查端口冲突

在现代的微服务架构中，Docker 被广泛应用于应用程序的交付和部署。然而，随着容器数量的增多，端口冲突变成了一个常见问题。端口冲突通常会导致容器启动失败，影响开发和生产环境的正常运行。本文将介绍如何排查 Docker 中的端口冲突问题，并提供一些代码示例。

什么是端口冲突？

端口冲突发生在多个服务试图绑定同一个网络端口时。例如，如果你在本地机器上运行了一个 Web 服务器（通常默认使用 80 端口），并试图再通过 Docker 启动另一个服务（也想使用 80 端口），那么就会导致端口冲突。

如何排查端口冲突？

步骤一：检查正在运行的容器

首先，我们需要检查哪些容器当前正在运行，并查看它们占用的端口。可以使用以下命令列出所有当前运行的容器和它们的端口映射：

docker ps

该命令输出类似如下内容：

CONTAINER ID   IMAGE          COMMAND                  CREATED        STATUS        PORTS                   NAMES
abcdef123456   nginx          "/docker-entrypoint.…"   2 hours ago    Up 2 hours    0.0.0.0:80->80/tcp      my-nginx
ghijkl789012   my_app        "python app.py"          3 hours ago    Up 3 hours    0.0.0.0:5000->5000/tcp  my_app

从以上输出中，我们可以看到 my-nginx 容器正在使用主机的 80 端口，而 my_app 容器正在使用 5000 端口。

步骤二：查找冲突的端口

如果要检查某个特定端口是否已被占用，可以用以下命令：

lsof -i :80

如果有其他进程正在使用该端口，输出将显示这些进程的信息。例如：

COMMAND   PID USER   FD   TYPE DEVICE SIZE/OFF NODE NAME
nginx   12345 root   6u  IPv4  1234567      0t0  TCP *:80 (LISTEN)

如果该端口正被 nginx 服务占用，那么在尝试启动新的 Docker 容器时，默认也将无法使用 80 端口。

步骤三：解决冲突

解决冲突的方式有两种：

停止正在运行的服务：如果你不再需要使用该服务，可以停止它。例如，停止运行的 nginx 服务：
```
sudo systemctl stop nginx
```
更改 Docker 容器的端口映射：在运行 Docker 容器时，可以将容器内部的默认端口映射到主机的其他端口。例如，如果想要将 my_app 的 5000 端口映射到主机的 8080 端口，可以使用以下命令：
```
docker run -p 8080:5000 my_app
```

这样，你就可以通过 http://localhost:8080 访问 my_app。

端口冲突排查流程

为了帮助理解，我们可以用下面的旅行图来概述排查和解决端口冲突的流程：

journey
    title 端口冲突排查流程
    section 检查容器状态
      列出运行的容器: 5: 列出所有运行的容器以检查端口
    section 查找冲突端口
      使用 lsof 查找冲突端口: 5: 检查特定端口是否被占用
    section 解决冲突
      停止占用服务: 3: 停止运行的服务
      更改容器端口映射: 5: 在 Docker 启动时更改端口映射