linux排查docker宿主机端口占用需分四步：先查运行容器端口映射，再用ss或lsof查系统进程，接着检查已停止但未删除的残留容器，最后排查docker守护进程或网络配置异常。
Linux中排查Docker宿主机端口占用，核心是分清“谁在用这个端口”——可能是其他Docker容器、本地进程（如Nginx、Python服务），也可能是已停止但未清理的残留容器仍在绑定端口。关键不在于盲目重启，而在于快速定位并精准处理。
查正在运行的Docker容器是否占了端口
先确认是不是自己启动的容器之间冲突：
- 运行 docker ps --format "table {{.Names}}\t{{.Ports}}"，查看所有运行中容器的端口映射情况
- 若目标端口（比如8080）已在某容器的 PORTS 列中出现，说明它正被占用
- 进一步用 docker port
查看该容器具体绑定了哪些宿主机端口
查宿主机上所有监听该端口的进程
排除Docker后，检查系统级占用：
- 用 sudo ss -tuln | grep ':8080' 快速列出监听8080的TCP/UDP连接（推荐，比netstat更快）
- 或用 sudo lsof -iTCP:8080 -sTCP:LISTEN 直接显示进程名、PID和用户，信息更完整
- 如果输出为空，说明端口当前未被任何进程监听；若有结果，记下PID，再用 ps -p PID -o pid,comm,args 确认进程用途
别漏掉已停止但未删除的容器
很多情况下，错误提示“port is already allocated”，其实是因为一个 Exited 状态的容器仍保留着端口绑定：
- 运行 docker ps -a | grep ':8080' 或 docker ps -a --filter "expose=8080" --format "{{.ID}} {{.Status}} {{.Names}}"
- 若发现有 stopped 容器映射了该端口，直接执行 docker rm -f
彻底清理 - 也可批量清理： docker rm -f $(docker ps -aq --filter "status=exited")
检查Docker守护进程自身或网络配置
极少数情况，Docker daemon或自定义网络会间接影响端口可用性：
- 运行 sudo netstat -tulnp | grep docker，看 dockerd 是否意外监听了业务端口（正常不应如此）
- 检查是否有自定义 bridge 网络设置了 host 级别端口映射，或使用了 host 网络模式导致端口直通冲突
- 临时验证：重启 Docker 服务 sudo systemctl restart docker，可释放部分异常持有的端口资源（注意这会中断所有运行中容器）
