是docker容器端口映射占用了frankenphp端口；需用netstat或lsof查宿主机端口占用，确认docker-proxy等进程后，通过docker ps -a检查ports列或inspect定位具体容器，再stop验证。
查 Docker 容器是否占了 FrankenPHP 的端口
FrankenPHP 启动失败报 socket 占用，而你刚跑过 Docker 容器——大概率是宿主机端口被某个容器的 -p 映射占了。Docker 本身不暴露 PID，但它的端口绑定会透出到系统级监听列表里，必须从宿主机视角查。
在管理员权限的 PowerShell 或 CMD 中执行：
netstat -ano | findstr :8000
把 :8000 换成你 FrankenPHP 配置里实际监听的端口（比如 :80、:443、:9000）。如果输出中某行末尾 PID 对应的进程名是 docker-proxy.exe，那就坐实了：是 Docker 在“代持”这个端口。
- 若没看到
docker-proxy.exe，但有containerd-shim.exe或com.docker.backend.exe占着，也属 Docker 生态残留 - 若 PID 对应的是
System且值为 4，那是 Windows HTTP.sys，和 Docker 无关，别往 Docker 上猜 - Linux/macOS 用户请用
sudo lsof -i :8000或sudo netstat -tulnp | grep :8000，原理相同，只是进程名显示为docker-proxy或直接是容器 PID
确认具体是哪个容器在映射该端口
光知道是 Docker 占的还不够，得定位到具体容器。因为 docker-proxy 不带容器名，得反向查。
先列出所有已创建的容器（含已停止的）：
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
docker ps -a --format "table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.Ports}}"
重点看 Ports 列，找包含 0.0.0.0:8000->、127.0.0.1:8000-> 这类字符串的行。只要这里出现你的目标端口，就是它。
- 若
Ports列为空，但容器状态是Up X hours ago，说明它可能用了--network host模式，直接复用宿主机网络栈，此时端口占用不会显式出现在Ports列，需结合netstat输出的 PID 查docker inspect - 若多个容器都映射了同一宿主端口（比如都写了
-p 80:80），Docker 只会让第一个成功，其余启动失败——但第一个仍牢牢占着端口 - 已
stop但未rm的容器，Ports列可能仍显示旧映射，属于假阳性；真正释放要等docker rm或 Docker daemon 重启
快速验证：停掉可疑容器再试 FrankenPHP
别急着改配置或杀进程，先做最小验证：停掉疑似容器，立刻重试 frankenphp serve。
假设你从上一步查到容器名是 php-dev：
docker stop php-dev<br>frankenphp serve
如果 FrankenPHP 成功启动，就闭环了——问题出在这个容器。后续可选：
- 永久改容器启动命令，换宿主端口：比如把
-p 8000:80改成-p 8001:80 - 删掉旧容器再重建：
docker rm -f php-dev，避免下次又撞上 - 改 FrankenPHP 配置里的
server.address，避开常用开发端口（如 8000/8080/9000），选个冷门端口如127.0.0.1:8091
真正容易被忽略的是：Docker 容器即使 Exited 状态，只要没 rm，它的端口映射记录仍保留在 daemon 内部，netstat 不显示，但新容器或 FrankenPHP 仍无法绑定——这种“幽灵占用”只能靠 docker ps -a 扫描全量容器来揪出。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
