[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"blog-strapi-article:zh:go-http2-proxy-transport-tls-debugging":3,"blog-article:\u002Fblog\u002Fgo-http2-proxy-transport-tls-debugging":561,"blog-related:\u002Fblog\u002Fgo-http2-proxy-transport-tls-debugging":562,"blog-translations:\u002Fblog\u002Fgo-http2-proxy-transport-tls-debugging":563},{"available":4,"article":5,"relatedArticles":158,"translations":461},true,{"source":6,"id":7,"documentId":8,"translationKey":8,"locale":9,"slug":10,"path":11,"_path":11,"title":12,"description":13,"excerpt":13,"image":14,"publishedAt":15,"updatedAt":16,"author":17,"tags":18,"featured":19,"sortOrder":20,"readingTime":21,"bodyType":22,"bodyBlocks":23,"bodyHtml":157},"strapi",3378,"iygwbvs7oeb00z6dpmj0eoza","zh","go-http2-proxy-transport-tls-debugging","\u002Fblog\u002Fgo-http2-proxy-transport-tls-debugging","Go HTTP\u002F2 代理连接怎么调试：Transport、TLS 与连接复用","调试 Go HTTP\u002F2 代理连接时，分开检查 Transport、CONNECT、TLS\u002FALPN、连接池和超时，并用日志确认每一层的实际状态。","https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_Go_HTTP_2_Transport_TLS_cover_36c215586d.webp","2026-10-15T08:30:16.550Z","2026-10-15T08:30:16.535Z","Global Proxies Team",[],false,0,2,"blocks",[24,30,34,39,43,47,51,55,59,63,68,72,76,80,84,88,92,96,100,104,109,113,117,121,125,129,133,137,141,145,149,153],{"type":25,"children":26},"paragraph",[27],{"text":28,"type":29},"Go 的代理连接、TLS 握手和 HTTP\u002F2 协商处于不同阶段。先确认实际使用的 Transport，再按 CONNECT、TLS、ALPN、连接池和超时顺序定位。","text",{"type":25,"children":31},[32],{"text":33,"type":29},"Go 的代理隧道、TLS 握手和 HTTP\u002F2 协商处于不同阶段。先确认实际请求使用的 `http.Transport`，再按连接建立顺序定位；HTTP\u002F2 不是代理 IP 类型。",{"type":35,"level":21,"children":36},"heading",[37],{"text":38,"type":29},"如何确认请求使用了目标 Transport",{"type":25,"children":40},[41],{"text":42,"type":29},"检查 `Proxy`、`DialContext`、`TLSClientConfig` 和各级超时是否来自同一个 Transport。SDK 可能覆盖自定义 RoundTripper，因此日志应记录目标 URL、代理地址、Transport 标识和连接耗时。无法确认实例时，先做一个最小请求并与直连结果对照。",{"type":25,"children":44},[45],{"text":46,"type":29},"多语言接入示例可参考[代理 IP 代码示例中心](https:\u002F\u002Fwww.quanqiudaili.com\u002Fdevelopers\u002Fcode-examples\u002F)。",{"type":35,"level":21,"children":48},[49],{"text":50,"type":29},"CONNECT、TLS 和 ALPN 的排查顺序",{"type":25,"children":52},[53],{"text":54,"type":29},"CONNECT 成功只表示代理隧道建立，不代表目标 TLS 或 HTTP\u002F2 已成功。分别记录 CONNECT 状态、TLS 版本、证书校验、ALPN 提供值和最终协商协议；未得到 `h2` 时先核对 Go 客户端与目标站支持，不要关闭证书校验。",{"type":25,"children":56},[57],{"text":58,"type":29},"需要区分代理协议和 TLS 连接层时，可参考[HTTP、HTTPS、SOCKS5 代理怎么选](https:\u002F\u002Fwww.quanqiudaili.com\u002Fblog\u002Fhttp-https-socks5-proxy-selection)。",{"type":25,"children":60},[61],{"text":62,"type":29},"下面按连接建立顺序把日志字段对应到故障阶段。",{"type":64,"children":65},"code",[66],{"text":67,"type":29},"| 阶段 | 观察字段 | 常见异常 | 下一步 |\n| --- | --- | --- | --- |\n| CONNECT | 状态码、认证结果 | 407、连接拒绝 | 查代理认证和主机端口 |\n| TLS | 证书、版本、耗时 | 校验失败、握手超时 | 查 CA 和中间层 |\n| ALPN | 提供值、协商协议 | 未得到 h2 | 查客户端和目标支持 |\n| 响应头 | 首字节、响应头耗时 | 长时间无响应 | 区分上游等待和网络延迟 |\n| 连接池 | 新建\u002F复用、关闭时间 | 仅复用失败 | 关闭复用做对照 |",{"type":25,"children":69},[70],{"text":71,"type":29},"从最早异常的阶段开始处理，再比较新建连接和复用连接的差异。",{"type":35,"level":21,"children":73},[74],{"text":75,"type":29},"连接池复用和超时问题怎么查",{"type":25,"children":77},[78],{"text":79,"type":29},"把 connect、TLS handshake、response header 和 read 分开计时。若只有复用连接失败，暂时关闭空闲连接或新建 Transport 做对照；若新建连接也在同一阶段超时，再回查该阶段的网络或 TLS。",{"type":25,"children":81},[82],{"text":83,"type":29},"连接池参数和并发规划可进一步参考[代理 IP 并发、QPS 和连接池怎么规划](https:\u002F\u002Fwww.quanqiudaili.com\u002Fblog\u002Fproxy-ip-concurrency-qps-connection-pool)。",{"type":25,"children":85},[86],{"text":87,"type":29},"一轮调试至少应确认隧道、证书和协议结果，并记录新建与复用连接的差异。",{"type":35,"level":21,"children":89},[90],{"text":91,"type":29},"如何从日志定位失败阶段",{"type":25,"children":93},[94],{"text":95,"type":29},"建议在不记录认证值的前提下，保存目标 URL、Transport 标识、代理地址摘要、CONNECT 状态、TLS 版本、证书校验结果、ALPN 提供值、最终协议、response header 时间和 read 时间。若 CONNECT 失败，先处理代理认证或主机端口；若 TLS 失败，检查 CA 和中间层；若只在复用连接失败，比较 idle connection 的创建和关闭时间。",{"type":35,"level":21,"children":97},[98],{"text":99,"type":29},"怎样确认 HTTP\u002F2 协商成功",{"type":25,"children":101},[102],{"text":103,"type":29},"一轮调试至少应确认：请求确实使用预期 Transport、CONNECT 隧道建立、证书校验通过、ALPN 结果符合目标支持情况。目标站不支持 h2 时，未协商到 h2 不等于代理故障，应确认客户端能否按目标支持的协议继续请求。",{"type":35,"level":105,"children":106},3,[107],{"text":108,"type":29},"用一组日志区分新建连接和复用连接",{"type":25,"children":110},[111],{"text":112,"type":29},"可用脱敏字段把失败阶段映射到日志，不要记录认证值：",{"type":25,"children":114},[115],{"text":116,"type":29},"```text\nurl=https:\u002F\u002Fapi.example.test\u002Fping transport=T1 connect=120ms tls=85ms alpn=h2 response_header=210ms read=18ms status=200\nurl=https:\u002F\u002Fapi.example.test\u002Fping transport=T1 reused=true connect=0ms response_header=timeout\n```",{"type":25,"children":118},[119],{"text":120,"type":29},"第一行表示隧道、TLS、HTTP\u002F2 和响应均完成；第二行只在复用连接超时，应先关闭空闲连接做新建连接对照。HTTP\u002FHTTPS\u002FSOCKS5 透明代理接入仍只需要主机、端口、账号和密码；TLS\u002F证书\u002FALPN 是目标连接诊断字段，不是额外代理账号字段。",{"type":35,"level":21,"children":122},[123],{"text":124,"type":29},"FAQ",{"type":35,"level":105,"children":126},[127],{"text":128,"type":29},"CONNECT 成功是否代表 HTTP\u002F2 可用？",{"type":25,"children":130},[131],{"text":132,"type":29},"不代表，后面还要完成 TLS 和 ALPN 协商。",{"type":35,"level":105,"children":134},[135],{"text":136,"type":29},"如何确认请求使用了预期的 Transport？",{"type":25,"children":138},[139],{"text":140,"type":29},"检查实际客户端使用的 Transport，以及 `Proxy`、`DialContext` 和 TLS 配置是否属于该实例。SDK 或自定义 RoundTripper 可能覆盖单独创建的 Transport。",{"type":35,"level":105,"children":142},[143],{"text":144,"type":29},"ALPN 没有协商到 h2 时先检查什么？",{"type":25,"children":146},[147],{"text":148,"type":29},"先确认目标站支持 HTTP\u002F2，再检查 Go 客户端配置和 TLS 中间层。没有协商到 h2 不一定代表代理连接失败。",{"type":35,"level":105,"children":150},[151],{"text":152,"type":29},"只有连接池复用时出错怎么办？",{"type":25,"children":154},[155],{"text":156,"type":29},"用新建连接做对照。如果新连接正常，再检查 idle connection 的生命周期和 Transport 复用设置。","",[159,242,360],{"source":6,"id":160,"documentId":161,"translationKey":161,"locale":9,"slug":162,"path":163,"_path":163,"title":164,"description":165,"excerpt":165,"image":166,"publishedAt":167,"updatedAt":168,"author":17,"tags":169,"featured":19,"sortOrder":20,"readingTime":21,"bodyType":22,"bodyBlocks":170,"bodyHtml":157},3476,"di2d61b0ntbxfkmt4rkgunhp","gemini-cli-proxy-http-socks5-environment-variables","\u002Fblog\u002Fgemini-cli-proxy-http-socks5-environment-variables","Gemini CLI 代理怎么设置：HTTP_PROXY 与 HTTPS_PROXY","了解 Gemini CLI 的 HTTP(S) 代理设置方式，按当前版本配置 HTTPS_PROXY、HTTP_PROXY，并验证主模型请求是否经过代理。","https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_gemini_cli_http_socks5_cover_3bd4a7598d.webp","2026-10-20T09:43:02.426Z","2026-10-20T09:43:02.393Z",[],[171,175,179,183,187,191,195,199,203,207,211,215,219,223,226,230,234,238],{"type":35,"level":172,"children":173},1,[174],{"text":164,"type":29},{"type":25,"children":176},[177],{"text":178,"type":29},"配置 Gemini CLI 代理 IP 前，先确认当前版本读取的代理环境变量及支持的协议，再从设置变量的同一终端启动 CLI。代理环境变量决定请求是否尝试经由指定网络出口连接；HTTP、HTTPS、SOCKS5 是接入协议，不代表代理 IP 的住宅属性或质量。",{"type":35,"level":21,"children":180},[181],{"text":182,"type":29},"先确认当前 Gemini CLI 版本读取哪些代理变量",{"type":25,"children":184},[185],{"text":186,"type":29},"先记录 Gemini CLI 版本、操作系统和安装方式，再查看该版本文档或帮助信息，确认它实际读取哪些代理变量以及支持哪些协议。不要预设 `HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY` 或 SOCKS5 一定可用；官方配置说明见 [Gemini CLI 配置文档](https:\u002F\u002Fgeminicli.com\u002Fdocs\u002Freference\u002Fconfiguration\u002F)。",{"type":35,"level":21,"children":188},[189],{"text":190,"type":29},"为当前终端的 Gemini CLI 主模型请求设置 HTTP(S) 代理",{"type":25,"children":192},[193],{"text":194,"type":29},"以下示例针对 Gemini CLI 主模型请求的 HTTP(S) 代理环境变量；不据此推断 MCP、沙箱或工具子进程一定继承同一设置。先记录安装版本，并确认该版本支持相应变量，再从设置变量的同一终端启动 CLI：",{"type":25,"children":196},[197],{"text":198,"type":29},"```powershell\n$env:HTTPS_PROXY = \"http:\u002F\u002F主机:端口\"\n$env:HTTP_PROXY = \"http:\u002F\u002F主机:端口\"\ngemini --help\ngemini\n```",{"type":25,"children":200},[201],{"text":202,"type":29},"```bash\nexport HTTPS_PROXY=\"http:\u002F\u002F主机:端口\"\nexport HTTP_PROXY=\"http:\u002F\u002F主机:端口\"\ngemini --help\ngemini\n```",{"type":25,"children":204},[205],{"text":206,"type":29},"以上分别是 PowerShell 与 Linux\u002FmacOS shell 设置当前终端变量的示例。是否读取变量取决于 Gemini CLI 版本；核实版本文档与 `gemini --help` 后，再用低风险主模型请求及代理日志验证。不要把含凭证 URL 写入共享脚本、命令历史或截图。本节不提供 SOCKS5\u002F`ALL_PROXY` 配置承诺，因为当前可核实的官方读取链未确认支持它们。",{"type":25,"children":208},[209],{"text":210,"type":29},"临时使用后可清除本节设置的变量：PowerShell 用 `Remove-Item Env:HTTP_PROXY,Env:HTTPS_PROXY -ErrorAction SilentlyContinue`；Linux\u002FmacOS 用 `unset HTTP_PROXY HTTPS_PROXY`。若变量原本已存在，先记录原值并在结束后恢复。",{"type":35,"level":21,"children":212},[213],{"text":214,"type":29},"检查 Gemini CLI 是否经过代理并连通服务",{"type":25,"children":216},[217],{"text":218,"type":29},"从设置变量的同一终端发起一条低风险主模型请求，结合代理侧连接日志确认该请求是否经过代理。MCP、沙箱和工具子进程需分别验证各自网络路径。CLI 无法连接代理时，可参照已发布的[代理 IP 连接排查表](https:\u002F\u002Fwww.quanqiudaili.com\u002Fblog\u002Fproxy-ip-connection-troubleshooting)检查主机、端口和认证。",{"type":64,"children":220},[221],{"text":222,"type":29},"| 现象 | 检查项 | 下一步 |\n| --- | --- | --- |\n| CLI 未读代理设置 | 变量名称、大小写、启动终端及版本行为 | 对照当前版本官方说明 |\n| 代理认证失败 | 主机、端口、凭证格式和凭证字符转义 | 修正接入参数并保护凭证 |\n| 网络正常但服务报错 | CLI\u002FAPI 认证、配额、服务状态和请求参数 | 按服务端错误分层排查 |",{"type":35,"level":21,"children":224},[225],{"text":124,"type":29},{"type":35,"level":105,"children":227},[228],{"text":229,"type":29},"设置 `HTTPS_PROXY` 后，怎么确认 Gemini CLI 确实走了代理？",{"type":25,"children":231},[232],{"text":233,"type":29},"从设置变量的同一终端启动 CLI，发起一条低风险请求，并结合进程环境、客户端或代理日志、出口检测确认请求路径。仅看到变量已设置，不能证明当前版本的 CLI 已读取它。",{"type":35,"level":105,"children":235},[236],{"text":237,"type":29},"HTTP 和 SOCKS5 哪个更适合？",{"type":25,"children":239},[240],{"text":241,"type":29},"本文示例使用 HTTP(S) 代理变量。当前版本是否支持其它代理协议，应查该版本文档；设置未确认读取的变量不能证明请求已使用相应代理。协议本身也不能说明代理 IP 的住宅\u002F机房属性或业务结果。",{"source":6,"id":243,"documentId":244,"translationKey":244,"locale":9,"slug":245,"path":246,"_path":246,"title":247,"description":248,"excerpt":248,"image":249,"publishedAt":250,"updatedAt":251,"author":17,"tags":252,"featured":19,"sortOrder":20,"readingTime":105,"bodyType":22,"bodyBlocks":253,"bodyHtml":157},3475,"x4a9q0bme23m2tka73ym65lm","nginx-websocket-400-502-504-troubleshooting","\u002Fblog\u002Fnginx-websocket-400-502-504-troubleshooting","Nginx WebSocket 反向代理排查：400、502、504 与超时","Nginx WebSocket 反向代理返回 400、502 或 504 时，按 Upgrade 握手、上游连接和超时日志逐项排查，并用 curl 与 websocat 验证配置。","https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_nginx_websocket_400_502_504_cover_a2295cdc39.webp","2026-10-20T09:42:46.326Z","2026-10-20T09:42:46.313Z",[],[254,258,262,266,270,274,278,282,286,290,294,298,302,306,310,314,318,322,326,329,333,337,341,345,348,352,356],{"type":25,"children":255},[256],{"text":257,"type":29},"Nginx WebSocket 反向代理返回 400、502 或 504 时，先记录响应状态并对照 Nginx 和上游日志。本文排查的是 Nginx 到上游的反向代理链路；400 优先检查请求或握手，502 检查上游连接与响应，504 检查上游响应时间和超时设置。状态码只能指示排查方向，根因要结合日志确认。",{"type":35,"level":21,"children":259},[260],{"text":261,"type":29},"配好 Upgrade 和 Connection 转发头",{"type":25,"children":263},[264],{"text":265,"type":29},"先确认客户端是否发送 WebSocket 握手请求。Nginx 反向代理通常需要使用 HTTP\u002F1.1，并将 Upgrade 与 Connection 头转给上游。配置结构如下，需放在正确的 `http`、`server` 或 `location` 层级，并按实际上游调整。",{"type":25,"children":267},[268],{"text":269,"type":29},"可对照 [Nginx 官方 WebSocket 代理说明](https:\u002F\u002Fnginx.org\u002Fen\u002Fdocs\u002Fhttp\u002Fwebsocket.html)检查 Upgrade 转发行为；具体指令以部署版本文档为准。",{"type":25,"children":271},[272],{"text":273,"type":29},"```nginx\nproxy_http_version 1.1;\nproxy_set_header Upgrade $http_upgrade;\nproxy_set_header Connection $connection_upgrade;\nproxy_set_header Host $host;\nproxy_connect_timeout 5s;\nproxy_read_timeout 60s;\n```",{"type":25,"children":275},[276],{"text":277,"type":29},"上例假设已在 `http` 层用 `map $http_upgrade $connection_upgrade { default upgrade; '' close; }` 定义 `$connection_upgrade`，并配置了对应 `proxy_pass` 和上游；按实际上游替换。`5s` 与 `60s` 只是示例值，需依据网络和心跳要求调整。`proxy_connect_timeout` 限制建立上游连接的等待时间；`proxy_read_timeout` 限制两次从上游读取数据之间的空闲间隔，不能修复连接拒绝或错误握手。",{"type":25,"children":279},[280],{"text":281,"type":29},"超时指令的版本和上下文限制见 [Nginx 官方 proxy 模块文档](https:\u002F\u002Fnginx.org\u002Fen\u002Fdocs\u002Fhttp\u002Fngx_http_proxy_module.html#proxy_read_timeout)。",{"type":25,"children":283},[284],{"text":285,"type":29},"随后查看客户端网络面板，确认失败发生在握手阶段还是握手之后。",{"type":35,"level":21,"children":287},[288],{"text":289,"type":29},"看 400、502、504 判断请求卡在哪一环",{"type":64,"children":291},[292],{"text":293,"type":29},"| 状态码 | 优先检查 | 证据位置 | 后续动作 |\n| --- | --- | --- | --- |\n| 400 | 请求路径、Upgrade\u002FConnection 头、上游对握手的校验 | 客户端请求、Nginx access log、上游响应 | 对照协议要求和上游路由，不盲目延长超时 |\n| 502 | 上游地址\u002F端口、连接拒绝、DNS 解析及上游进程状态 | Nginx error log、上游服务日志 | 先从 Nginx 主机验证到上游的连接 |\n| 504 | 上游处理时间、连接\u002F读取超时设置、服务负载 | error log 时间戳、上游耗时和负载 | 找出等待发生在哪一跳，再评估超时配置 |",{"type":25,"children":295},[296],{"text":297,"type":29},"用 access log 中的时间、URI、状态码及上游状态\u002F耗时字段找到请求，再查看对应的 error log 和上游日志，确认请求是否到达上游、在哪一跳失败。不同版本和上游实现的返回状态可能不同，应沿同一请求的日志链路判断。",{"type":35,"level":21,"children":299},[300],{"text":301,"type":29},"用客户端和两端日志复现并定位故障",{"type":25,"children":303},[304],{"text":305,"type":29},"记录 Nginx 版本、脱敏后的相关配置、目标路径、发生时间、响应状态、请求 ID 和上游日志。先验证客户端到 Nginx，再验证 Nginx 到上游；每次只调整一个配置项后复测。不要公开 token、Cookie、Authorization 头或内网敏感地址。",{"type":25,"children":307},[308],{"text":309,"type":29},"配置变更后先检查语法，再平滑重载，并分别验证普通 HTTP 与 WebSocket 握手。以下命令需在 Nginx 主机执行，域名和路径按环境替换：",{"type":25,"children":311},[312],{"text":313,"type":29},"```bash\nsudo nginx -t\nsudo nginx -s reload\ncurl -i https:\u002F\u002Fexample.com\u002Fws\nwebsocat -v wss:\u002F\u002Fexample.com\u002Fws\n```",{"type":25,"children":315},[316],{"text":317,"type":29},"`nginx -t` 失败时不要 reload。普通 curl 通常没有发送完整 Upgrade 握手，不能用它判定 WebSocket 成功；`websocat` 应完成握手并建立连接，成功响应为 `101 Switching Protocols`。结合 Nginx access\u002Ferror log 中的 `$upstream_status`、`$upstream_connect_time` 和 `$upstream_response_time` 定位失败阶段。",{"type":35,"level":21,"children":319},[320],{"text":321,"type":29},"根据日志区分握手失败、上游连接失败和响应超时",{"type":25,"children":323},[324],{"text":325,"type":29},"请求未到达上游时，检查 Nginx 配置、DNS 和连接；上游返回 400 时核对 Upgrade\u002FConnection 请求头、路径和上游校验；上游连接被拒绝或出现 502 时检查地址、端口及服务状态；只有日志显示请求已到达上游且等待超过当前限制时，才按官方 proxy 模块文档评估超时。每次只改一个配置项，并用相同路径复测。",{"type":35,"level":21,"children":327},[328],{"text":124,"type":29},{"type":35,"level":105,"children":330},[331],{"text":332,"type":29},"`proxy_read_timeout` 调大后仍返回 504，下一步看什么？",{"type":25,"children":334},[335],{"text":336,"type":29},"按正文日志分支确认请求是否到达上游、等待发生在哪一跳，再检查上游耗时和服务负载；不要只通过继续增大超时处理上游不可用或链路异常。",{"type":35,"level":105,"children":338},[339],{"text":340,"type":29},"`curl` 返回 200 就能证明 WebSocket 正常吗？",{"type":25,"children":342},[343],{"text":344,"type":29},"不能。普通 curl 请求不一定发送 WebSocket Upgrade 握手；应使用 WebSocket 客户端验证，并确认握手成功返回 `101 Switching Protocols`，再观察连接是否按预期维持。",{"type":25,"children":346},[347],{"text":157,"type":29},{"type":25,"children":349},[350],{"text":351,"type":29},"---",{"type":35,"level":21,"children":353},[354],{"text":355,"type":29},"对照日志复测 WebSocket 修复结果",{"type":25,"children":357},[358],{"text":359,"type":29},"按失败请求的时间戳复核 access\u002Ferror log 与上游日志，再用相同路径确认握手是否返回 101、连接能否维持。若故障发生在客户端代理 IP 到 Nginx 之前，应另查客户端到代理的连接链路。",{"source":6,"id":361,"documentId":362,"translationKey":362,"locale":9,"slug":363,"path":364,"_path":364,"title":365,"description":366,"excerpt":366,"image":367,"publishedAt":368,"updatedAt":369,"author":17,"tags":370,"featured":19,"sortOrder":20,"readingTime":21,"bodyType":22,"bodyBlocks":371,"bodyHtml":157},3474,"k1c5f17zwlsh9vx5sz4dolif","websocket-proxy-connection-troubleshooting","\u002Fblog\u002Fwebsocket-proxy-connection-troubleshooting","WebSocket 代理 IP 连接失败怎么办：认证、TLS 与 Upgrade 排查","WebSocket 通过代理 IP 连接失败时，可按代理连接、认证、TLS 隧道和 Upgrade 握手逐步排查，并用最小验证确认故障环节。","https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_websocket_cover_3f066ac782.webp","2026-10-20T09:42:30.996Z","2026-10-20T09:42:30.971Z",[],[372,376,380,384,388,392,396,400,404,408,412,416,420,424,428,431,435,439,443,447,450,453,457],{"type":25,"children":373},[374],{"text":375,"type":29},"WebSocket 通过代理 IP 连接失败时，先确定使用的是客户端正向代理还是服务端反向代理，再判断失败发生在 TCP 连接、代理认证、TLS 还是 WebSocket Upgrade 阶段。按时间戳保存客户端错误、代理日志和目标服务响应；只有证据指向代理连接或会话问题时，才继续调整代理参数。",{"type":35,"level":21,"children":377},[378],{"text":379,"type":29},"先确认失败在代理连接、TLS 还是 WebSocket 握手",{"type":25,"children":381},[382],{"text":383,"type":29},"常见路径是客户端连接代理，再通过代理到达目标服务，随后完成 TLS（如使用 WSS）和 WebSocket 握手。若 Nginx 在服务端作为反向代理，应按 Nginx 反向代理链路单独排查；不要把两种代理角色混为一谈。主机、端口、认证或连接问题可参考已发布的[代理 IP 连接排查表](https:\u002F\u002Fwww.quanqiudaili.com\u002Fblog\u002Fproxy-ip-connection-troubleshooting)。",{"type":35,"level":21,"children":385},[386],{"text":387,"type":29},"从客户端错误判断连接失败在哪一步",{"type":64,"children":389},[390],{"text":391,"type":29},"| 现象 | 可能阶段 | 检查内容 | 下一步 |\n| --- | --- | --- | --- |\n| 无法连接代理地址 | 客户端到代理 | 主机、端口、协议、网络连通性 | 验证接入参数及本地网络 |\n| 407 或代理认证失败 | 代理认证 | 用户名、密码、认证类型和 URL 转义 | 修正凭证并避免在日志中泄露 |\n| TLS 错误或握手中断 | TLS\u002F隧道 | 客户端是否支持该代理协议及目标 TLS | 查看客户端错误和代理日志 |\n| HTTP 响应正常但 Upgrade 失败 | WebSocket 握手\u002F目标服务 | Upgrade 请求头、目标路径、服务端响应 | 核对客户端与目标服务配置 |\n| 连接建立后很快断开 | 会话\u002F网络链路 | 空闲超时、心跳、代理会话和目标端日志 | 固定条件复现并记录断开时间 |",{"type":25,"children":393},[394],{"text":395,"type":29},"HTTP、HTTPS、SOCKS5 是接入协议，不代表住宅或数据中心属性。客户端是否支持 WebSocket 通过特定代理协议，应查其当前文档；不要根据协议名称推断兼容性。",{"type":35,"level":21,"children":397},[398],{"text":399,"type":29},"从代理连接开始验证，直到收到 Upgrade 响应",{"type":25,"children":401},[402],{"text":403,"type":29},"记录客户端版本、脱敏后的目标 URL、代理协议、错误信息、发生时间和连接时长。先用客户端连接测试或受控目标确认目标服务可用，再对照[代理参数说明](https:\u002F\u002Fhelp.quanqiudaili.com\u002Fdocs\u002Fintro)核对主机、端口和认证参数；随后分别验证代理认证、TLS 和 WebSocket Upgrade 响应。每轮只改一个变量，并保存客户端、代理和目标服务日志。遇到 403、429 或验证码时，按目标站规则停止或调整请求。",{"type":25,"children":405},[406],{"text":407,"type":29},"下面的 `proxy.example.com`、端口和 URL 都是占位值；命令用 curl 检查 HTTP(S) 代理连通性，不能单独证明 WebSocket Upgrade 成功。凭证优先通过受保护的环境变量传入，避免写进命令历史或截图：",{"type":25,"children":409},[410],{"text":411,"type":29},"```bash\ncurl -v --proxy http:\u002F\u002Fproxy.example.com:8080 \\\n--proxy-user \"$PROXY_USER:$PROXY_PASS\" \\\nhttps:\u002F\u002Fexample.com\u002F -o \u002Fdev\u002Fnull\n```",{"type":25,"children":413},[414],{"text":415,"type":29},"先看代理连接是否建立及是否出现 `407`。目标返回正常 HTTP 响应仅表示普通请求经代理完成，不代表 Upgrade 成功。WebSocket 验证应使用客户端连接实际 `wss:\u002F\u002F` 地址，并检查服务端是否返回 `101 Switching Protocols`；若收到 `400\u002F403` 等响应，记录状态和响应头，并按目标规则停止不必要重试。",{"type":25,"children":417},[418],{"text":419,"type":29},"curl 示例只验证普通 HTTP(S) 经代理的连接，不能代替 WebSocket 握手。实际 WSS 验证需使用明确支持 HTTP CONNECT 或 SOCKS 代理的 WebSocket 客户端，并连到自有测试端；核对代理认证成功、握手返回 `101`、消息可收发且连接可正常关闭。客户端及其代理参数因库和版本不同，只有核验具体客户端后才应给出可复制命令；不要把不确定支持代理的工具当作验证步骤。",{"type":35,"level":21,"children":421},[422],{"text":423,"type":29},"按连接阶段判断应该检查哪一端",{"type":25,"children":425},[426],{"text":427,"type":29},"代理连接或认证失败时，核对代理主机、端口、协议和认证；TLS 隧道失败时，查看客户端支持范围及 TLS 错误；代理已连通但 Upgrade 失败时，检查目标路径、握手请求和服务端响应；建立后很快断开时，检查空闲超时、心跳和会话规则。若问题发生在 Nginx 到上游的反向代理链路，应按对应 Nginx WebSocket 配置排查。每轮只调整一个变量。",{"type":35,"level":21,"children":429},[430],{"text":124,"type":29},{"type":35,"level":105,"children":432},[433],{"text":434,"type":29},"HTTP 代理也能承载 WebSocket 吗？",{"type":25,"children":436},[437],{"text":438,"type":29},"取决于客户端和代理是否支持相应的隧道或 Upgrade 流程。不要单凭协议名称判断兼容性；用实际客户端连接目标 `ws:\u002F\u002F` 或 `wss:\u002F\u002F` 地址，并检查握手响应及连接日志。",{"type":35,"level":105,"children":440},[441],{"text":442,"type":29},"连接失败时应先换代理 IP 吗？",{"type":25,"children":444},[445],{"text":446,"type":29},"先定位失败阶段。只有证据指向代理连接、认证或隧道问题时，才考虑调整代理；目标服务或应用层错误应检查对应配置。",{"type":25,"children":448},[449],{"text":157,"type":29},{"type":25,"children":451},[452],{"text":351,"type":29},{"type":35,"level":21,"children":454},[455],{"text":456,"type":29},"按故障位置复核 WebSocket 连接配置",{"type":25,"children":458},[459],{"text":460,"type":29},"把失败时间、代理协议、客户端版本、阶段、状态码和脱敏日志交给客户端或代理服务支持团队；若确认故障位于 Nginx 到上游链路，再按对应反向代理配置排查。",[462],{"source":6,"id":7,"documentId":8,"translationKey":8,"locale":9,"slug":10,"path":11,"_path":11,"title":12,"description":13,"excerpt":13,"image":14,"publishedAt":15,"updatedAt":16,"author":17,"tags":463,"featured":19,"sortOrder":20,"readingTime":21,"bodyType":22,"bodyBlocks":464,"bodyHtml":157},[],[465,468,471,474,477,480,483,486,489,492,495,498,501,504,507,510,513,516,519,522,525,528,531,534,537,540,543,546,549,552,555,558],{"type":25,"children":466},[467],{"text":28,"type":29},{"type":25,"children":469},[470],{"text":33,"type":29},{"type":35,"level":21,"children":472},[473],{"text":38,"type":29},{"type":25,"children":475},[476],{"text":42,"type":29},{"type":25,"children":478},[479],{"text":46,"type":29},{"type":35,"level":21,"children":481},[482],{"text":50,"type":29},{"type":25,"children":484},[485],{"text":54,"type":29},{"type":25,"children":487},[488],{"text":58,"type":29},{"type":25,"children":490},[491],{"text":62,"type":29},{"type":64,"children":493},[494],{"text":67,"type":29},{"type":25,"children":496},[497],{"text":71,"type":29},{"type":35,"level":21,"children":499},[500],{"text":75,"type":29},{"type":25,"children":502},[503],{"text":79,"type":29},{"type":25,"children":505},[506],{"text":83,"type":29},{"type":25,"children":508},[509],{"text":87,"type":29},{"type":35,"level":21,"children":511},[512],{"text":91,"type":29},{"type":25,"children":514},[515],{"text":95,"type":29},{"type":35,"level":21,"children":517},[518],{"text":99,"type":29},{"type":25,"children":520},[521],{"text":103,"type":29},{"type":35,"level":105,"children":523},[524],{"text":108,"type":29},{"type":25,"children":526},[527],{"text":112,"type":29},{"type":25,"children":529},[530],{"text":116,"type":29},{"type":25,"children":532},[533],{"text":120,"type":29},{"type":35,"level":21,"children":535},[536],{"text":124,"type":29},{"type":35,"level":105,"children":538},[539],{"text":128,"type":29},{"type":25,"children":541},[542],{"text":132,"type":29},{"type":35,"level":105,"children":544},[545],{"text":136,"type":29},{"type":25,"children":547},[548],{"text":140,"type":29},{"type":35,"level":105,"children":550},[551],{"text":144,"type":29},{"type":25,"children":553},[554],{"text":148,"type":29},{"type":35,"level":105,"children":556},[557],{"text":152,"type":29},{"type":25,"children":559},[560],{"text":156,"type":29},null,[],[]]