是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 不带容器名,得反向查。
立即学习“PHP免费学习笔记(深入)”;
先列出所有已创建的容器(含已停止的):
在 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 扫描全量容器来揪出。


















