Hermes 连接 xAI 报 502？一个 aiohttp 代理参数是关键

有开发者在本地通过 Hermes 接入 xAI 的 API 时，聊天接口持续返回 502 与 upstream_unreachable 错误。排查发现，直连 api.x.ai 会超时，而通过本机代理可正常访问，由此将问题锁定在 Hermes 安装包内的代理实现上。该实现使用 Python 的 aiohttp 库创建 ClientSession 会话，而 aiohttp 默认不读取代理环境变量，导致仅设置 HTTP_PROXY、HTTPS_PROXY 并不生效。修复方式是在 hermes_cli/proxy/server.py 中创建会话的位置补上 trust_env=True 参数，同时保留原有参数，并配置代理环境变量，将 localhost 与 127.0.0.1 加入 NO_PROXY，避免本地请求被错误导入代理。重启服务后，模型列表已能正常返回，但作者指出这尚不能证明完整对话链路已恢复，仍需实际发起对话验证。由于直接修改安装文件可能在版本升级时被覆盖，建议先行备份。作者总结的排查思路是：先对比直连与代理访问的结果，再检查客户端是否真正读取了代理配置。该案例对在代理环境下使用 AI CLI 工具接入境外模型 API 的开发者具有直接参考价值。

事件分析

核心观点：代理兼容性是 AI CLI 工具落地时最易被忽视的基础细节，一行 trust_env 之差即是可用与不可用的分界。