端口已被占用:容器无法绑定
快速摘要
你的容器无法绑定端口 —— 另一个进程或容器已在使用它。
为什么发生
主机上的另一个容器或进程已在同一端口上监听
前一个容器实例未停止,仍持有端口
docker-compose 或 run 命令中的端口映射与其他服务冲突
最小示例
✗ 错误代码
# docker-compose.yml
services:
web:
ports:
- '80:80'
api:
ports:
- '80:8080' # conflict — port 80 already used by web✓ 修复代码
# docker-compose.yml
services:
web:
ports:
- '80:80'
api:
ports:
- '8080:8080' # different host port — no conflict将 api 服务映射到不同的主机端口(8080)避免了与 web 服务在端口 80 上的冲突。
如何诊断
检查哪个进程在使用端口:netstat -tulpn | grep :PORT 或 lsof -i :PORT
用 docker ps 列出运行中的容器及其端口映射
验证 docker-compose 或 run 命令中的端口映射是否有冲突
如何修复
停止使用该端口的进程或容器
更改容器的端口映射以使用不同的主机端口
使用 Docker 网络让容器通信而无需主机端口绑定
如何预防
使用端口管理策略或动态端口分配以避免冲突
记录端口分配并使用 docker-compose 集中管理端口映射
相关资源
相关术语
相关课程
- 容器网络
学习端口。