如何在生产环境启动laravel-echo-server？nginx代理无响应排查

第一步：基础连通性验证 #

• 打开浏览器开发者工具的「网络」面板，筛选WS类型，刷新页面查看是否有socket.io相关请求，记录返回状态码。
• 在生产服务器本地执行命令：curl http://localhost:6001/socket.io/?EIO=4&transport=polling，若返回包含sid、upgrades字段的JSON内容，说明laravel-echo-server本身运行正常。
• 再执行：curl https://example.com/socket.io/?EIO=4&transport=polling，若返回404说明nginx代理转发异常；若返回内容和本地一致，说明代理链路正常，问题出在前端连接配置。

核心问题1：前端Echo配置路径错误 #

你当前的配置把代理路径写在了host参数中，会导致socket.io-client重复拼接路径：现有host: 'https://example.com/socket.io'的配置会被解析为目标地址https://example.com，额外将/socket.io识别为命名空间，最终请求路径会变成/socket.io/socket.io/，完全匹配不到nginx的转发规则。

• 正确的前端配置需要把代理路径单独放到path字段：

window.Echo = new Echo({
    broadcaster: 'socket.io',
    host: 'https://example.com',
    path: '/socket.io',
    auth: {
        headers: {
            'Authorization': `Bearer ${localStorage.getItem('token')}`
        }
    }
});

• 修改完配置后，重新执行Vue项目构建，部署新的dist文件到服务器，避免旧打包缓存生效。

核心问题2：Nginx代理缺失长连接必要参数 #

你当前的/socket.io/ location配置缺少WebSocket长连接的超时配置和转发头，会导致握手失败或连接中途断开，补充以下参数：

location /socket.io/ {
    proxy_pass http://localhost:6001;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_set_header Host $host;
    # 新增以下配置
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_read_timeout 86400s;
    proxy_send_timeout 86400s;
}

核心问题3：后端鉴权与广播配置校验 #

• 确认Laravel项目config/cors.php已放行/broadcasting/auth接口的跨域请求，允许的请求头包含Authorization字段。
• 确认Laravel项目config/broadcasting.php的默认驱动设置为兼容laravel-echo-server的pusher类型，且配置的key、secret、app_id和laravel-echo.server.json中clients的配置完全一致。
• 确认定义私有聊天频道的channels.php路由返回逻辑正常，不会因鉴权逻辑错误直接抛403。

生产环境加固要求 #

• 不要直接用laravel-echo-server start在前台运行服务，用pm2或systemd将其设为后台守护进程，避免SSH断开后服务自动停止。
• 确认服务器防火墙仅开放80/443端口，不对公网暴露6001端口，所有WebSocket流量统一走nginx反代。

内容的提问来源于stack exchange，提问作者Tyoma Inagamov