适用场景Hermes或其他 Python OpenAI SDK 客户端调用 OpenCode Go 订阅的模型deepseek-v4-flash、grok-4.5、kimi-k3 等响应极慢120 秒而 DeepSeek 官方 API、Claude CLI 却很快。一、问题现象在 Hermes 中配置 OpenCode Go 订阅后调用模型每次 API 调用固定120~130 秒同一台服务器上DeepSeek 官方 API约 2 秒 ✅Claude CLI 调 OpenCode很快 ✅curl直接请求 OpenCode APITTFB 0.4 秒 ✅Python httpx 请求20~200 秒 ❌结论模型本身不慢是客户端身份的问题。二、排查证据为什么是 Cloudflare 的锅测试TTFBcurllibcurl TLS 指纹0.2~0.4sPython httpx / requestsOpenSSL 指纹1.5~200s随频率累积curl_cffi 模拟 Chrome 指纹1.3~1.7s响应头确认server: cloudflare cf-ray: a27b8672ce4f75b2-SEAopencode.ai 在 Cloudflare 后面。Cloudflare 对 Python/OpenSSL 的 TLS 指纹执行了延迟处理类似 bot 检测而 curl / 浏览器指纹直接放行。这就是为什么DeepSeek 官方 API不走 Cloudflare快Claude CLI原生二进制TLS 栈不同快HermesPython httpx慢三、解决方案本地 curl_cffi 代理思路让 Hermes 的请求先到本地代理代理用curl_cffi 模拟 Chrome 浏览器 TLS 指纹转发到 opencode.ai绕过 Cloudflare 的指纹识别。Hermes ── 127.0.0.1:18080 (curl_cffi 代理, Chrome 指纹) ── opencode.ai只影响 opencode-go 这一个 provider其他 providerDeepSeek、mimo 等完全直连不受影响。效果状态延迟修复前直连120~130s修复后走代理2~7s四、实施步骤1. 安装 curl_cffi假设 Hermes 装在~/hermes-agent使用 venvcd~/hermes-agent venv/bin/python-mpipinstallcurl_cffi验证venv/bin/python-cimport curl_cffi; print(curl_cffi.__version__)2. 创建代理脚本sudomkdir-p/opt/opencode-proxysudochown$USER:$USER/opt/opencode-proxy创建/opt/opencode-proxy/proxy.py#!/usr/bin/env python3opencode.ai 本地代理curl_cffi 模拟 Chrome TLS 指纹转发请求importhttp.serverimportsocketserverimportsysfromcurl_cffiimportrequests# 注意不要带 /v1Hermes 请求路径自带 /v1UPSTREAMhttps://opencode.ai/zen/goIMPERSONATEchrome# 模拟 Chrome 浏览器 TLS 指纹LISTEN_HOST127.0.0.1LISTEN_PORT18080classHandler(http.server.BaseHTTPRequestHandler):# HTTP/1.0连接结束以 EOF 表示 SSE 流结束protocol_versionHTTP/1.0deflog_message(self,fmt,*args):sys.stderr.write([proxy] %s\n%(fmt%args))def_forward(self):lengthint(self.headers.get(Content-Length,0)or0)bodyself.rfile.read(length)iflengthelsebheaders{Content-Type:self.headers.get(Content-Type,application/json),Authorization:self.headers.get(Authorization,),Accept:application/json,}urlUPSTREAMself.pathtry:responserequests.post(url,contentbody,headersheaders,impersonateIMPERSONATE,streamTrue,timeout300,)exceptExceptionasexc:self.send_response(502)self.send_header(Content-Type,text/plain; charsetutf-8)self.end_headers()self.wfile.write((proxy error: %s\n%exc).encode())returnself.send_response(response.status_code)self.send_header(Content-Type,response.headers.get(Content-Type,text/event-stream),)self.send_header(Cache-Control,no-cache)self.end_headers()try:# 关键按原始字节流转发保留 SSE 空行事件分隔符# 不要用 iter_lines()会吞掉空行导致 SDK 解析失败forchunkinresponse.iter_content(chunk_size8192):ifchunk:self.wfile.write(chunk)self.wfile.flush()except(BrokenPipeError,ConnectionResetError):passexceptException:passdo_POST_forward do_GET_forwardclassThreadingServer(socketserver.ThreadingMixIn,http.server.HTTPServer):daemon_threadsTrueallow_reuse_addressTrueif__name____main__:serverThreadingServer((LISTEN_HOST,LISTEN_PORT),Handler)print(f[proxy] listening on{LISTEN_HOST}:{LISTEN_PORT}-{UPSTREAM},flushTrue)try:server.serve_forever()exceptKeyboardInterrupt:pass3. 先手动启动测试cd~/hermes-agent venv/bin/python /opt/opencode-proxy/proxy.py另开终端测试把KEY换成你的 keycurl-sN-o/dev/null-wHTTP: %{http_code} | TTFB: %{time_starttransfer}s | 总: %{time_total}s\n\--max-time60-XPOST http://127.0.0.1:18080/v1/chat/completions\-HContent-Type: application/json\-HAuthorization: Bearer 你的key\-d{model:deepseek-v4-flash,messages:[{role:user,content:hi}],max_tokens:5}预期HTTP: 200总耗时几秒。4. 配置 systemd 开机自启创建/etc/systemd/system/opencode-proxy.service[Unit] DescriptionOpenCode curl_cffi TLS proxy Afternetwork-online.target Wantsnetwork-online.target [Service] Typesimple User你的用户名 ExecStart/home/你的用户名/hermes-agent/venv/bin/python /opt/opencode-proxy/proxy.py Restartalways RestartSec3 EnvironmentPYTHONUNBUFFERED1 [Install] WantedBymulti-user.target启动sudosystemctl daemon-reloadsudosystemctlenable--nowopencode-proxysudosystemctl status opencode-proxy# 确认 active (running)5. 修改 Hermes 配置把 opencode-go 的 base_url 指向本地代理# 先确认 opencode-go 在 custom_providers 里的索引从 0 开始hermes config get custom_providers|grep-nname: opencode-go# 假设索引是 2把 base_url 改成本地代理hermes configsetcustom_providers.2.base_urlhttp://127.0.0.1:18080/v1验证hermes config get custom_providers.2.base_url# 应输出 http://127.0.0.1:18080/v16. 重启 Hermes Gatewaysystemctl--userrestart hermes-gateway五、验证是否生效grepAPI call~/.hermes/logs/agent.log|tail-5修复前latency126.8s修复后latency2.4s也可以直接聊天测试。CLI 首次启动要加载技能/记忆几十秒是正常的以日志里的latency为准。六、常见问题1. 返回 404路径重复了。代理脚本里UPSTREAM https://opencode.ai/zen/go不能带 /v1请求路径自带 /v1否则变成/v1/v1/chat/completions。2. 报 EmptyStreamError / chunks0代理用了iter_lines()或过滤了空行。SSE 事件用空行分隔必须用iter_content()按原始字节转发。3. 端口被占用ss-tlnp|grep18080# 看谁占着pkill-fopencode-proxy/proxy.pysudosystemctl restart opencode-proxy4. 改完还是慢检查三件事sudosystemctl is-active opencode-proxy# 代理在跑吗hermes config get custom_providers.2.base_url# 指向 127.0.0.1:18080 吗grepAPI call~/.hermes/logs/agent.log|tail-1# 日志里 latency 多少七、注意事项API Key 安全本方案中 key 只存于 Hermes 配置代理透传不改写。发布教程时务必用***打码。只影响 opencode-go其他 providerDeepSeek 官方、mimo 等的 base_url 没改完全直连。代理挂了会怎样Hermes 会快速报连接错误比 120 秒卡死好发现得多systemd 会自动拉起。合规提醒这只是改变 HTTP 客户端 TLS 特征不涉及任何破解/绕过鉴权请遵守 OpenCode 服务条款。