Skip to content

端口已被占用:容器无法绑定

快速摘要

你的容器无法绑定端口 —— 另一个进程或容器已在使用它。

为什么发生

  • 主机上的另一个容器或进程已在同一端口上监听

  • 前一个容器实例未停止,仍持有端口

  • 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 集中管理端口映射

相关资源

相关术语

相关课程

← 返回语言