代理配置

Hermes Agent 需要调用海外 AI 服务（如 OpenAI、Anthropic），在国内网络环境下需要配置代理。

如果你在海外服务器部署，或使用国内可直连的 AI 服务商（如 DeepSeek 硅基流动），可以跳过本配置。

原理

Hermes 容器 → HTTP 代理 → 海外出口 → AI API 服务

代理是一个中间服务，负责把网络请求转发到海外。Hermes 使用 mihomo（Clash Meta 内核）作为代理服务。

第一步：准备代理订阅

你需要一个代理服务商的订阅链接（通常在购买代理服务后，服务商会提供一个 URL，以 https:// 开头）。

本手册不推荐具体服务商。自行搜索”Clash 订阅”、“机场订阅”了解。

第二步：配置代理文件

创建代理配置文件 mihomo-config.yaml：

port: 7890
socks-port: 7891
allow-lan: true
mode: rule
log-level: info

# 代理节点（从订阅 URL 获取）
proxies:
  # 这里的内容通常由订阅自动生成

# 代理组
proxy-groups:
  - name: Proxy
    type: select
    proxies:
      - 你的节点名称

# 规则 —— 哪些走代理，哪些直连
rules:
  - DOMAIN-SUFFIX,openai.com,Proxy
  - DOMAIN-SUFFIX,anthropic.com,Proxy
  - DOMAIN-SUFFIX,api.github.com,Proxy
  - GEOIP,CN,DIRECT
  - MATCH,Proxy

使用订阅自动生成

大多数代理服务商提供”Clash 配置文件下载”。可以直接保存为 mihomo-config.yaml 使用。

# 用订阅 URL 下载配置
curl -o mihomo-config.yaml "你的订阅链接"

第三步：配置 Docker Compose

在 docker-compose.yml 中添加代理容器：

services:
  hermes:
    # ... 其他配置 ...
    environment:
      - http_proxy=http://mihomo:7890
      - https_proxy=http://mihomo:7890
    depends_on:
      - mihomo

  mihomo:
    image: ghcr.io/metacubex/mihomo:latest
    container_name: mihomo
    volumes:
      - ./mihomo-config.yaml:/root/.config/mihomo/config.yaml
    ports:
      - "7890:7890"
      - "9090:9090"  # 控制面板端口
    cap_add:
      - NET_ADMIN

第四步：启动并验证

# 重新创建容器（加上了 mihomo 服务）
docker compose up -d

# 验证代理连通性
docker exec hermes-agent curl -x http://mihomo:7890 -I https://api.openai.com

应该返回 HTTP/2 200 或类似的状态码。

锁定出口地区（可选）

AI 服务商可能有地域限制。可以在配置中指定出口地区：

proxy-groups:
  - name: Proxy
    type: select
    proxies:
      - 美国节点  # 选择美国节点以确保兼容性

调试代理

查看代理状态

# 查看 mihomo 日志
docker compose logs mihomo

# 查看连接的节点
curl http://localhost:9090/proxies

测试延迟

# 测试代理延迟
curl -x http://127.0.0.1:7890 -o /dev/null -s -w "%{time_total}s\n" https://www.google.com

常见问题

问题：代理无法连接

检查订阅是否过期。 docker compose logs mihomo 看具体错误。

问题：部分网站能上，AI API 连不上

检查规则配置，确保 AI 服务商的域名走代理。试试把 MATCH,Proxy 改为全部走代理。

问题：国内网站打不开

检查 GEOIP 规则是否生效。可以在规则中添加：DOMAIN-SUFFIX,baidu.com,DIRECT

下一步

配置完成后，进入 基础配置 设置 API Key。