企业官网建设流程全解析

Hermes Agent 网络提速实操：2 条协议、3 个坑，把网关连接做稳

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent

接口慢到用户流失，不是玄学，是协议选型问题。Hermes Agent 的桌面客户端连远程 gateway 时踩得最深的一点：HTTP 和 WebSocket 是两条独立链路，却常被当成一条来监控。这篇文章按"先看差异、再最小配置、最后排坑"的顺序讲清楚 HTTP/2 与 WebSocket 在 Hermes Agent 里怎么分工。

📋 HTTP/2 与 WebSocket 核心差异一张表

Hermes Agent 的实际分工就是这张表的注脚：主进程用 HTTP 打GET /api/status确认后端存活，渲染进程用 WebSocket 连/api/ws拉消息流。前者管"活着没"，后者管"数据流不流"。

⚙️ HTTP/2 多路复用怎么开：一行命令

uvicorn 原生不支持 h2，最省事的路径是换 hypercorn，一行起服务：

hypercorn gateway:app --bind 0.0.0.0:8000

为什么这么配：gateway 一次冷启动要并发拉模型元数据、配额、会话列表等十几个资源，HTTP/1.1 下这些请求在同源连接上排队；切到 HTTP/2 后全部帧级并发，冷启动的接口瀑布直接拍平。头部压缩默认开启，无需额外动作。

🔌 WebSocket 最小配置：两行代码建连

参考 网关连接配置 的做法，核心就两步：

const url = `wss://${host}/api/ws?token=${encodeURIComponent(token)}` const ws = new WebSocket(url)

注意 token 必须encodeURIComponent——凭证里含/、+时，裸拼 URL 会让升级请求在握手阶段就 404，且报错信息指向 URL 解析而非鉴权，排查起来很绕。为什么用查询参数而不是 header：浏览器的WebSocket构造函数不允许自定义请求头，这是协议限制，不是偷懒。

桌面端左侧的会话列表和消息流，全部由这条 WebSocket 通道驱动更新。

⚠️ 避坑指南：真实部署最容易踩的 3 处

• HTTP 探活通过 ≠ WebSocket 可用。状态接口和/api/ws的升级请求走的是不同进程、不同凭证、不同校验（Host/Origin、ticket 鉴权、对端 IP）。只探 status 会看到"绿色已连接"，实际 UI 卡在连不上。解法：升级握手后加一个短宽限期，收到gateway.ready帧或宽限期内连接未断才算成功，参考 Gateway WS 探针 的实现——10s 连接超时 + 750ms 宽限窗。
• token 进 URL 会被日志完整打印。access log、代理日志都会原样记录查询串。内网可接受，公网部署建议换短时效 ticket 换 token 的模式，把长效凭证挡在 URL 之外。
• 断线重连没有退避 = 重连风暴。网络闪断时多个客户端同时裸重连，gateway 刚恢复就被打挂。参考 远端存活检查，指数退避加抖动，上限封顶 30s。

📊 性能锚点：优化后差多少

本地局域网、中等消息频率下可感知的参照值：

• 冷启动接口并发拉取：HTTP/1.1 P99 约 800ms，切 HTTP/2 后降到 200ms 量级，降幅主要来自请求不再排队
• 消息推送：HTTP 轮询 3s 间隔意味着最坏 3s 延迟；WebSocket 下帧到达即渲染，P99 端到端 < 100ms
• 重连风暴：无退避时 50 客户端闪断后 gateway 重连耗时可达 10s+，加退避后收敛到 1s 内

数字会随网络环境浮动，但量级差异是稳定的——这也是先跑最小链路、再拿自己环境的基线数的原因。

收束

协议选错，调参救不回来：API 并发走 HTTP/2，实时推送走 WebSocket，两条链路各自探活。下一步建议：先在你自己的 gateway 上跑通"status 探活 + WS 握手确认"这条最小链路，拿到 P99 基线，再回头调退避参数和宽限窗。

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent