Docker容器部署WebSocket服务教程解决Docker中WS端口转发方法-js教程-PHP中文网

websocket在docker中连不上，主因是服务监听地址写死为127.0.0.1而非0.0.0.0，导致端口映射失效；需绑定0.0.0.0、正确配置docker ports、前端使用宿主机ip+映射端口，并在nginx反代时透传upgrade头。

websocket 在 docker 容器里连不上，八成不是协议问题，而是服务监听地址写死了 127.0.0.1 或 localhost，导致容器内网络栈无法被外部映射端口访问到。

监听地址必须绑定 0.0.0.0 而非 127.0.0.1

容器内部的 127.0.0.1 指向的是容器自己，不是宿主机。Docker 的端口映射（如 -p 8988:8888）只转发到达容器 eth0 网络接口的流量，而 127.0.0.1:8888 根本不经过 eth0。

实操建议：

把服务启动代码里的监听地址从 "ws://127.0.0.1:8888" 改成 "ws://0.0.0.0:8888"（或对应框架的 bind 地址配置项，如 Node.js 的 server.listen(8888, '0.0.0.0')）
检查日志是否输出类似 Listening on 0.0.0.0:8888，而不是 127.0.0.1:8888
用 docker exec -it <container> netstat -tuln | grep 8888</container> 验证端口是否确实在 0.0.0.0 上监听

Docker Compose 中 ports 映射要显式声明

ports 字段不是“自动发现”，必须明确写出宿主机端口 → 容器端口的映射关系。只写 - "8888"（仅容器端口）不会对外暴露。

常见错误现象：

容器运行无报错，但 curl -i http://localhost:8988 直接超时或拒绝连接
docker ps 显示端口列为空，或只显示 8888/tcp（没带宿主机绑定）

正确写法示例（docker-compose.yml）：

services:
  ws-server:
    image: your-ws-app
    ports:
      - "8988:8888"  # 必须这样写，不能省略左边宿主机端口
    restart: unless-stopped

前端连接地址必须用宿主机 IP/域名 + 映射后端口

浏览器运行在宿主机（或局域网设备）上，它无法直接访问容器的 127.0.0.1，也不能用容器名（除非走自定义 Docker 网络且前端也在容器里）。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

使用场景与注意事项：

本地开发：前端用 ws://localhost:8988（对应 ports: - "8988:8888"）
局域网测试：用宿主机真实 IP，如 ws://192.168.1.100:8988，确保宿主机防火墙放行该端口
不要在前端硬编码 ws://127.0.0.1:8888 或 ws://container-name:8888 —— 这些在浏览器里必然失败
如果用了 Nginx 反代，必须加 WebSocket 握手头（见下一条）

Nginx 反向代理 WebSocket 必须透传 Upgrade 头

如果 WebSocket 服务前面挂了 Nginx，只做普通 HTTP 代理会直接断开连接 —— 因为 WebSocket 升级请求（Upgrade: websocket）被丢弃了。

关键配置项（nginx.conf 或 conf.d/*.conf）：

location /ws/ {
    proxy_pass http://ws-backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
}

容易踩的坑：