使用vlm-sglang-client模式，连接本地docker部署的sglang-server，使用demo.py调用，为什么回复连接不上sglang server？

[CalvinHujay]

[dosubot[bot]]

Hi @CalvinHujay! I'm Dosu and I’m helping the MinerU team.

你遇到“连接不上sglang server”的常见原因有：

1. Docker端口映射或监听地址问题：sglang-server 容器内必须用 --host 0.0.0.0 启动，并且 Docker 要有 -p 30000:30000 端口映射，否则主机访问不到容器服务。不能只监听 127.0.0.1，否则只能容器内访问，主机 demo.py 访问不到。详见官方文档说明。

2. server_url 参数：demo.py 或 CLI 必须用 -b vlm-sglang-client -u http://127.0.0.1:30000，server_url 必须和 Docker 映射一致，不能写成 0.0.0.0，要用主机能访问的 IP 或 localhost。代码要求 server_url 必须是有效的 HTTP 地址，否则直接报错代码实现。

3. 健康检查失败：vlm-sglang-client 会自动请求 /health_generate 检查服务健康，如果端口没映射好、服务没监听 0.0.0.0、或被防火墙拦截，都会导致连接失败或 RemoteProtocolError。你可以在主机上用 curl http://127.0.0.1:30000/health_generate 检查是否能返回 200。

4. 版本兼容性：sglang-server 镜像建议用 lmsysorg/sglang:v0.4.8 或更高版本，MinerU 2.x 依赖 sglang >=0.4.8，低版本会导致健康检查或协议不兼容相关讨论。

5. Docker网络隔离：如果你用的是 Docker Compose，profile 必须是 sglang-server，不是 mineru-sglang-server。否则服务可能没启动或端口没暴露PR修正。

排查建议：

• 用 docker ps 确认 30000 端口已映射到主机。
• 用 docker exec -it <容器名> netstat -tlnp 看服务是否监听 0.0.0.0:30000。
• 主机上 curl http://127.0.0.1:30000/health_generate 能否返回 200。
• 检查防火墙和安全组是否放行 30000 端口。
• 确认 demo.py 的 server_url 参数和实际端口一致。

如果还有问题，请补充你的 Docker 启动命令和 demo.py 的调用参数，方便进一步定位。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}