Docker提示“端口不可用”但docker ps未显示对应容器的问题

原因 #

错误提示明确显示TCP 0.0.0.0:5000端口已被占用，但docker ps输出里没有容器使用该端口，说明是宿主机上的非Docker进程占用了5000端口（比如本地启动的Web服务、后台运行的其他程序等）。

排查步骤 #

• Linux/macOS系统：执行以下命令定位占用端口的进程：

  lsof -i :5000
  # 或者用另一种方式
  netstat -tulpn | grep 5000
  

  输出结果会包含进程ID（PID）和对应的程序名称。

• Windows系统：执行以下命令查找占用端口的进程：

  netstat -ano | findstr :5000
  

  拿到PID后，打开任务管理器，通过PID找到对应的进程。

解决办法 #

1. 停止占用端口的进程：根据排查结果关闭占用5000端口的程序，之后重新执行你的Docker容器启动命令即可。
2. 更换Docker映射端口：如果不想停止原有进程，可以修改docker run命令的端口映射规则，将宿主机端口换成未被占用的端口（比如5001）：

   docker run -d --net foodtrucks-net -p 5001:5000 --name foodtrucks-web myname/foodtrucks-web
   

   后续访问服务时使用http://localhost:5001即可。

内容的提问来源于stack exchange，提问作者bugsyb