Hermes代理设置教程及配置方法

本文详细介绍了 Hermes Agent 五种灵活且实用的代理配置方法——包括环境变量、配置文件、命令行参数、SOCKS5 协议支持以及域名白名单（no_proxy）设置，覆盖从临时调试到企业级部署的各种网络场景；无论您正面临防火墙限制、内网访问障碍，还是需要对接本地大模型服务，都能快速找到适配方案，轻松打通 Hermes Agent 的外部通信链路。

如果您在使用 Hermes Agent 时无法正常访问外部服务或 API，可能是由于网络环境受限，需要通过代理服务器中转请求。以下是为 Hermes Agent 配置网络代理的具体操作方法：

一、通过环境变量配置代理

该方式适用于所有运行 Hermes Agent 的操作系统（Linux/macOS/Windows），代理设置将被进程自动继承，无需修改任何代码或配置文件。

1、打开终端（Linux/macOS）或命令提示符/PowerShell（Windows）。

2、执行以下命令设置 HTTP 和 HTTPS 代理（请将 http://192.168.1.100:8080 替换为您的实际代理地址）：

Linux/macOS：
export HTTP_PROXY=http://192.168.1.100:8080
export HTTPS_PROXY=http://192.168.1.100:8080

Windows PowerShell：
$env:HTTP_PROXY="http://192.168.1.100:8080"
$env:HTTPS_PROXY="http://192.168.1.100:8080"

3、启动 Hermes Agent 进程，例如：
python -m hermes_agent.main

二、在配置文件中声明代理参数

该方式直接修改 Hermes Agent 的主配置文件，适用于部署在容器或需持久化代理设置的场景，优先级高于环境变量。

1、定位到 Hermes Agent 的配置目录，通常为 ./config/config.yaml 或 ~/.hermes/config.yaml。

2、用文本编辑器打开该文件，在顶层添加如下字段（注意缩进为两个空格）：

proxy:
  http: http://192.168.1.100:8080
  https: http://192.168.1.100:8080

3、保存文件后重启 Hermes Agent 服务。

三、启动命令行传入代理参数

该方式适合临时调试或单次运行，不修改任何持久配置，代理仅对当前进程生效。

1、确认 Hermes Agent 支持 --proxy 参数（可通过 hermes_agent --help 查看）。

2、执行带代理参数的启动命令：

python -m hermes_agent.main --proxy http://192.168.1.100:8080

3、若需分别指定 HTTP/HTTPS 代理，使用双参数形式：

python -m hermes_agent.main --http-proxy http://192.168.1.100:8080 --https-proxy http://192.168.1.100:8080

四、使用 SOCKS5 代理配置

当企业网络强制使用 SOCKS5 协议时，Hermes Agent 可通过第三方库支持该协议，需确保已安装 PySocks。

1、执行 pip install PySocks 安装依赖。

2、在配置文件 config.yaml 中设置：

proxy:
  http: socks5://192.168.1.100:1080
  https: socks5://192.168.1.100:1080

3、验证 socks5 地址格式是否正确，必须以 socks5:// 开头，不可省略协议前缀。

五、跳过代理的域名白名单配置

某些内部服务（如本地 LLM 接口、私有知识库 API）不应经过代理，可通过 no_proxy 列表排除。

1、在环境变量中添加 no_proxy，多个域名用英文逗号分隔：

export NO_PROXY="localhost,127.0.0.1,hermes.internal,ai-dev.local"

2、若使用配置文件方式，添加字段：

proxy:
  http: http://192.168.1.100:8080
  https: http://192.168.1.100:8080
  no_proxy: localhost,127.0.0.1,hermes.internal

3、注意：no_proxy 中的域名不支持通配符，必须精确匹配主机名或 IP。

到这里，我们也就讲完了《Hermes代理设置教程及配置方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于Hermes Agent,HermesAgent的知识点！