Hermes代理网络超时修复 | AI生成和翻译

Home 2026.04 English 中文

---

问题：为什么在 Node.js v25.3.0 上运行 hermes-agent 中的 start_proxy 时会遇到这个 TypeError: terminated with ETIMEDOUT 错误？

回答：

这个错误是网络超时问题，出现在 Node.js 的 HTTP/HTTPS 客户端（使用 undici 库）内部，当时你的 hermes-agent 正在尝试发送一个出站请求。

发生了什么：

• 代码试图通过网络获取某些内容（很可能是 HTTPS 请求）。
• 连接已建立，但读取操作超时（read ETIMEDOUT）。
• Node.js 的 undici fetch 实现检测到中断/超时并抛出 TypeError: terminated。
• 根本原因是 Error: read ETIMEDOUT，错误码为 -60（这在 macOS 上是一种常见的超时错误）。

hermes-agent start_proxy 中常见的发生原因：

1. 网络连接问题 — 你的互联网连接暂时中断，或者存在高延迟/丢包现象。
2. 代理或防火墙干扰 — 由于你正在运行 start_proxy，hermes-agent 很可能尝试通过代理连接、连接到代理或连接到某个远程服务。防火墙、企业代理或 VPN 经常导致超时。
3. 目标服务器响应缓慢或无法访问 — hermes-agent 尝试访问的远程端点（例如配置服务器、认证服务或上游代理）未能快速响应。
4. DNS 解析或路由问题 — 在 macOS 切换网络或使用某些 Wi-Fi 设置时尤其常见。
5. 超时设置过低 — hermes-agent 或 Node.js 可能为请求设置了较短的默认超时时间。
6. macOS 特有的网络异常 — 错误码 -60 和 TLS 套接字关闭表明这是系统级别的套接字超时，这在 macOS 的某些网络配置下更容易发生。

如何修复：

• 检查你的互联网连接并重试。
• 如果你身处企业/VPN/代理网络之后，尝试暂时禁用 VPN 或检查 hermes-agent 中的代理设置。
• 如果工具支持，以更详细的日志模式运行 start_proxy（例如 DEBUG=* start_proxy 或任何 --verbose 标志），以查看具体是哪个 URL 正在被请求并发生超时。
• 如果 hermes-agent 有相关配置选项，增加网络超时时间。
• 重启路由器/调制解调器或切换到不同的网络（手机热点）进行测试。
• 更新 Node.js 或检查是否有新版本的 hermes-agent。
• 作为快速测试：在终端中运行 curl https://www.google.com（或怀疑的目标域名）以验证基本连接性。

如果错误持续发生，请分享：

• 你运行的完整命令（start_proxy 是否带有任何参数？）
• 错误发生前的任何输出
• hermes-agent 应该完成什么功能（是自定义工具、开源项目还是内部项目？）
• 你的网络设置（家庭、办公室、VPN？）

这将有助于进一步缩小问题范围。

参考：

• 无（基于标准 Node.js/undici 行为的错误分析）

---

Back Donate