问题大概率出在docker自身残留网络状态或iptables规则未清理干净：需检查docker ps --format输出、重启docker daemon、清空docker链iptables规则，或执行docker network prune及system prune彻底清理。
当你确认宿主机端口已无任何进程监听（lsof -i :8080 或 netstat -tuln | grep :8080 无输出），Docker 却仍报 port is already allocated，问题大概率出在 Docker 自身的残留网络状态或 iptables 规则未清理干净。
确认宿主机端口确实空闲
先排除误判：运行 sudo lsof -i :8080（Linux/macOS）或 netstat -ano | findstr :8080（Windows），确保输出为空。若仍有 PID 显示，说明端口未真正释放，回到常规排查流程。
注意：某些系统（如 macOS Monterey+）中 lsof 可能不显示 kernel-level 的绑定，此时补查 sudo ss -tuln | grep :8080 更可靠。
检查 Docker 内部是否残留端口映射
即使容器已 stop 或 rm，Docker 的网络栈可能仍保留旧的端口绑定记录。
运行 docker ps --format "table {{.Names}}\t{{.Ports}}" | grep :8080，查看是否有容器正映射该端口。
再运行 docker ps -a | grep "Up.*seconds\|Up.*minutes"，重点检查那些状态为 Up X seconds 却没出现在 docker ps 中的容器——它们可能是刚被 kill 但 dockerd 还未完成清理的“僵尸监听者”。
清除 Docker 网络层残留绑定
方法一：重启 Docker daemon（最直接）
Linux：执行 sudo systemctl restart docker；macOS（Docker Desktop）：右键菜单 → “Restart”；Windows：托盘图标右键 → “Restart Docker Desktop”。【重启后所有容器停止，未保存的数据会丢失】
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
方法二：手动刷新 iptables（仅 Linux）
Docker 依赖 iptables 实现端口转发。残留规则可能导致 dockerd 认为端口仍被占用。运行：sudo iptables -t nat -L DOCKER -n | grep :8080，若输出非空，说明规则还在。执行 sudo iptables -t nat -F DOCKER 清空 DOCKER 链，再启动容器。
方法三：重置 Docker 网络（影响范围较大）
执行 docker network prune 清理所有未使用的自定义网络；再运行 docker system prune -f（慎用）——它会删除所有停止容器、未使用网络、悬空镜像和构建缓存。【此操作不可逆，确保无重要未提交容器】
验证并启动容器
第一步：运行 docker run --rm -it alpine:latest ping -c 1 host.docker.internal（Linux/macOS）或 docker run --rm -it alpine:latest ping -c 1 172.17.0.1（验证 bridge 网络基础连通性）。
第二步：执行 docker run -d -p 8080:80 --name test-nginx nginx，观察是否仍报错。
第三步：若成功，立即用 curl http://localhost:8080 测试响应；若失败，说明底层网络命名空间或 dockerd 状态异常，需考虑重装 Docker 或切换到 rootless 模式复测。
