WebSocket 走代理连不上:和普通请求差在哪

普通网页走代理都正常,可一到实时聊天、行情推送、在线协作这类需要一直保持连接的功能,就连不上,或者连上一会儿就断。

这类功能用的是另一种连接方式,比普通请求多了好几个步骤,代理只要有一步不配合,就会失败。

这篇先教你判断连接断在哪一步,再讲三种常见原因和对应的处理。

如果是所有走代理的 https 请求都连不上、报通道建立失败,先看ERR_TUNNEL_CONNECTION_FAILED 怎么解决;这篇只讲长连接场景。

一、它和普通请求差在哪

普通请求是「问一句、答一句、挂电话」;WebSocket 是「打通电话之后一直不挂」。WebSocket 是一种让浏览器和服务器保持长期连接、随时互相发消息的技术,地址以 ws:// 或 wss:// 开头,后者是加密的。

打个比方:普通请求像寄信,寄一封回一封;WebSocket 像打电话,接通之后双方随时说话,直到有人挂断。

走代理时,它要经过三步:

  1. 开通道:先请求代理在你和目标服务器之间建立一条直通的通道。
  2. 握手升级:在通道里发一个特殊请求,请服务器「把这次连接升级成长连接」。服务器同意时,会回一个状态码 101。
  3. 保持连接:之后双方在这条连接上来回发消息,可能持续很久。

三步里任何一步不被代理支持,连接都会失败。

二、先判断:断在握手阶段,还是建立之后

握手阶段就断,是代理或中间环节不配合;建立之后才断,多半是超时把空闲连接掐了。两种情况方向完全不同,先分清。

在浏览器里看:

  1. 按 F12 打开开发者工具,切到「网络」(Network)标签。
  2. 在筛选按钮里选「WS」,只看长连接。
  3. 刷新页面,点开那条连接。
  4. 状态显示 101,并且「消息」(Messages)标签里有来回的数据:连接建立成功过,问题在建立之后。
  5. 状态不是 101,或者一直是待处理然后失败:问题在握手阶段。

用命令行看:下面这条命令的作用是通过代理发起一次长连接握手,并显示过程。看输出里有没有出现 101:

curl -v -x http://代理地址:端口 \
  -H "Connection: Upgrade" -H "Upgrade: websocket" \
  -H "Sec-WebSocket-Version: 13" -H "Sec-WebSocket-Key: SGVsbG8sIHdvcmxkIQ==" \
  https://目标网址/长连接路径

出现「101 Switching Protocols」说明握手能通过代理完成;没有出现,就是握手阶段的问题。

三、三种常见原因

原因 断在哪一步 怎么处理
代理不支持开通道,或不允许到这个端口 握手阶段,第一步就失败 确认代理支持建立通道;目标端口如果不是常见的 443,确认代理是否放行
中间设备改写或删掉了升级请求头 握手阶段,拿不到 101 改用加密的 wss:// 地址
空闲超时把连接掐了 建立之后,一段时间没消息就断 让程序定时发心跳消息

第二种为什么改用 wss:// 就好:用不加密的 ws:// 时,升级请求以明文经过代理,有的代理或公司网关会按普通请求处理,把「升级」相关的请求头删掉,服务器收不到就不会升级。用 wss:// 时,请求在加密通道里传,中间环节看不到也改不了。

第三种为什么心跳有用:代理和网关为了节省资源,会把一段时间没有动静的连接当成「已经不用了」并关掉。心跳就是程序隔一段时间发一条很小的消息,告诉中间环节「我还在用」。间隔要比中间环节的超时时间短。

四、程序里怎么让它走代理

很多长连接库不会自动读系统代理,要在代码里显式指定。

Python 的 websocket-client 库,下面这段的作用是通过 HTTP 代理建立一条加密长连接:

import websocket
ws = websocket.create_connection(
    "wss://目标网址/长连接路径",
    http_proxy_host="代理地址",
    http_proxy_port=端口,
    http_proxy_auth=("用户名", "密码"),
    proxy_type="http",
)

Node.js 的 ws 库,下面这段的作用相同,借助 https-proxy-agent 让连接走代理:

const WebSocket = require("ws");
const { HttpsProxyAgent } = require("https-proxy-agent");
const agent = new HttpsProxyAgent("http://用户名:密码@代理地址:端口");
const ws = new WebSocket("wss://目标网址/长连接路径", { agent });

不需要认证的代理,去掉用户名密码部分。密码里有 @ 等符号,先按URL 编码转写。

五、边界与产品对应

必须说清楚:长连接断开不一定是代理的问题。服务器主动关闭、服务器端的心跳要求没满足、网络本身不稳定,都会导致断开。可以先不走代理直连一次对比:直连也断,问题不在代理。

需要长时间保持同一条连接的任务,出口本身是否稳定会直接影响断开的频率。这类任务适合静态住宅 IP(按条数计费,出口长期不变);短时、可以随时重连的,可以用动态住宅 IP(按流量计费)。配置示例均为通用占位写法,具体连接信息以后台为准。我们提供免费试用。

六、常见问题

Q1. WebSocket 走代理为什么连不上?

A. 常见三种原因:代理不支持建立通道、中间设备删掉了升级请求头、空闲超时掐断连接。先判断断在握手阶段还是建立之后。

Q2. wss 和 ws 走代理有什么区别?

A. wss 是加密的,请求在加密通道里经过代理,不会被中间环节改写,走代理时更稳。

Q3. 连上一会儿就断怎么办?

A. 多半是空闲超时。让程序定时发心跳消息,间隔比中间环节的超时时间短。

Q4. 怎么确认握手成功了?

A. 在浏览器开发者工具里看那条连接的状态是不是 101,或者用 curl 看输出里有没有 101 Switching Protocols。


先测,再谈采购

先分清断在握手阶段还是建立之后,再对应处理——方向对了,问题通常很快解决。

申请免费试用

(本文基于 2026 年 10 月常见浏览器、curl 及 Python、Node.js 长连接库的通用行为整理,不同版本参数可能不同;示例中的地址与凭据均为占位写法。)

滚动至顶部