容器与云原生 / 系统课时
宿主端口冲突怎么定位
宿主端口冲突怎么定位
docker compose up 报端口已被占用时,关键不是立刻换端口,而是先确认冲突的是哪个宿主端口、由谁监听,再决定释放旧占用、修改映射,还是让现有网关继续统一入口。
学习目标
- 能从
ports配置中区分宿主端口与容器端口 - 能判断冲突来自旧容器还是宿主机进程
- 能根据服务职责选择停止占用、修改映射或复用入口
先确认冲突的是宿主端口
Compose 的短语法 HOST:CONTAINER 左侧才会占用宿主机端口。例如下面的 Web 服务让宿主机监听 8080,再转发到容器内的 80:
services:
web:
image: nginx:alpine
ports:
- "8080:80"如果另一个容器或宿主进程已经监听 8080,新容器就无法建立同样的发布规则。容器内部的 80 并不要求全局唯一;不同容器可以同时监听自己的 80。
实际项目还可能通过变量生成端口,因此先运行 docker compose config 查看插值和多文件合并后的最终配置,而不要只盯着某一个 YAML 文件。
先查是不是其他容器占用
把报错中的宿主端口替换到 <PORT>,先让 Docker 自己回答谁发布了它:
PORT="<PORT>"
docker ps --filter "publish=${PORT}" --format 'table {{.ID}} {{.Names}} {{.Ports}}'预期输出
CONTAINER ID NAMES PORTS
<ID> <NAME> 0.0.0.0:<PORT>->80/tcp如果出现容器记录,先确认它属于哪个项目、是否仍在提供流量,再决定是否停止。不要看到冲突就直接删除容器;同一台宿主机上常常还有别的 Compose 项目或手工启动的长期服务。
若列表只有表头,说明没有正在运行的 Docker 容器以常见发布方式占用该端口,应继续查宿主进程。
再查宿主机监听进程
Linux 可以直接查看监听 socket 对应的进程。下面仍需先把 <PORT> 替换成实际端口:
PORT="<PORT>"
sudo ss -ltnp "sport = :${PORT}"预期输出
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。只有目标宿主端口已经由预期服务监听,并且外部请求能到达正确容器,才算真正解决;单纯把报错换成另一个端口只是绕开了症状。