容器与云原生 / 系统课时

宿主端口冲突怎么定位

宿主端口冲突怎么定位

docker compose up 报端口已被占用时,关键不是立刻换端口,而是先确认冲突的是哪个宿主端口、由谁监听,再决定释放旧占用、修改映射,还是让现有网关继续统一入口。

学习目标

  • 能从 ports 配置中区分宿主端口与容器端口
  • 能判断冲突来自旧容器还是宿主机进程
  • 能根据服务职责选择停止占用、修改映射或复用入口

先确认冲突的是宿主端口

Compose 的短语法 HOST:CONTAINER 左侧才会占用宿主机端口。例如下面的 Web 服务让宿主机监听 8080,再转发到容器内的 80:

yaml
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"

如果另一个容器或宿主进程已经监听 8080,新容器就无法建立同样的发布规则。容器内部的 80 并不要求全局唯一;不同容器可以同时监听自己的 80。

实际项目还可能通过变量生成端口,因此先运行 docker compose config 查看插值和多文件合并后的最终配置,而不要只盯着某一个 YAML 文件。

先查是不是其他容器占用

把报错中的宿主端口替换到 <PORT>,先让 Docker 自己回答谁发布了它:

bash
PORT="<PORT>"
docker ps --filter "publish=${PORT}" --format 'table {{.ID}}	{{.Names}}	{{.Ports}}'

预期输出

text
CONTAINER ID   NAMES        PORTS
<ID>           <NAME>       0.0.0.0:<PORT>->80/tcp

如果出现容器记录,先确认它属于哪个项目、是否仍在提供流量,再决定是否停止。不要看到冲突就直接删除容器;同一台宿主机上常常还有别的 Compose 项目或手工启动的长期服务。

若列表只有表头,说明没有正在运行的 Docker 容器以常见发布方式占用该端口,应继续查宿主进程。

再查宿主机监听进程

Linux 可以直接查看监听 socket 对应的进程。下面仍需先把 <PORT> 替换成实际端口:

bash
PORT="<PORT>"
sudo ss -ltnp "sport = :${PORT}"

预期输出

text
State   Recv-Q  Send-Q  Local Address:Port  Peer Address:Port  Process
LISTEN  <N>     <N>     0.0.0.0:<PORT>      0.0.0.0:*          users:(("<PROCESS>",pid=<ID>,fd=<ID>))

这里真正要确认的是进程名和 PID。常见占用者可能是系统 Nginx、开发服务器、数据库代理或没有纳入当前 Compose 项目的服务。若没有任何 LISTEN 行,再检查是否看错了协议、地址族或实际生效的 Compose 配置。

按职责选择修复方式

冲突来源明确后再处理,通常只有三类选择:

  • 旧服务本应退出:在它自己的项目目录执行 docker compose down,或按运维流程停止对应宿主进程。
  • 两个服务都要保留:修改其中一个宿主端口,容器端口通常不需要跟着改变。例如把 "8080:80" 改成 "18080:80"。
  • 现有入口就是统一网关:不要让后端服务再次抢占同一个宿主端口。让 Nginx、Traefik 或其他入口继续监听公开端口,后端只在 Compose 网络中暴露容器端口,由网关按服务名转发。

修改映射后再次执行 docker compose up -d,并用 docker compose ps 检查 PORTS。只有目标宿主端口已经由预期服务监听,并且外部请求能到达正确容器,才算真正解决;单纯把报错换成另一个端口只是绕开了症状。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

宿主端口冲突怎么定位

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通