现象
服务器上起第二个容器时,doCker run -p 8080:80 直接失败,报 driver failed programming external connectivity: Bind for 0.0.0.0:8080 failed: port is already allocated,容器没起来,可 netstat 里又看不出是谁占着。
原因
端口被占用有两种来源:宿主机上别的进程在监听,或者另一个容器已经把这个端口映射出去。Docker 通过 iptables 和 docker-proxy 转发,容器占用的端口在普通 netstat 里不一定显示为监听,所以只查进程容易漏。
解决步骤
第一步,先分清是宿主机进程还是容器。
docker ps --format "table {{.Names}}\t{{.Ports}}"
ss -lntp | grep 8080
docker ps -a --filter "publish=8080"
第二步,宿主机进程占用就换端口或停进程。确认业务允许后结束旧服务,或把映射改成 -p 8081:80;改完记得同步 Nginx 上游和防火墙规则。
第三步,容器占用就处理旧容器。docker stop 掉旧容器再启动新的;确认不再需要的用 docker rm 删除。长期方案是把端口写进 compose 文件统一管理,启动前先 docker compose down 清干净。
验证
docker ps 显示新容器 Up 且端口映射正确,curl 请求 127.0.0.1:8080 返回预期内容,ss 里只剩 docker-proxy 在监听,说明端口已正常交出。
小结
port is already allocated 的关键是分清占用方。先 docker ps 再 ss,两步就能定位,盲目重启 Docker 反而会牵连其他容器。
