hermes proxy 命令 — 完整参考与示例

概述

hermes proxy 运行一个本地 HTTP 服务器，将 OpenAI 兼容请求转发到已进行 OAuth 认证的提供商。外部应用可以使用任意 Bearer Token 指向该代理；代理会自动附上 Hermes 的真实凭据，因此任何 OpenAI 兼容客户端都能把 Hermes 当作即插即用的后端使用。

hermes proxy <start|status|providers>

子命令

start — 在前台运行代理

hermes proxy start
hermes proxy start --provider nous --host 127.0.0.1 --port 8645
hermes proxy start --provider xai --port 9090

status — 显示上游是否就绪

hermes proxy status

输出已配置上游提供商的就绪状态，让你在把客户端指向前代理之前确认其可服务请求。

providers — 列出可用上游提供商

hermes proxy providers

显示代理当前支持的上游提供商（目前为 nous 和 xai）。

常见场景

让其他 OpenAI 兼容工具使用 Hermes

hermes proxy start --port 8080
# 在另一个工具中设置：
#   API base: http://localhost:8080/v1
#   API key:  任意值（代理负责认证）

在局域网暴露代理

hermes proxy start --host 0.0.0.0 --port 8645

切换上游提供商

hermes proxy providers
hermes proxy start --provider xai

用 curl 测试代理

hermes proxy start --port 8645 &
curl http://localhost:8645/v1/models

技巧

• 默认情况下代理只监听本地（127.0.0.1），除非你修改 --host，否则不会暴露到公网。
• 客户端的 Bearer Token 可以填任意值；代理会使用 Hermes 的真实 OAuth 凭据。
• 代理必须在前台运行；如需长期使用，请在独立终端或进程管理器中启动。
• 连接客户端前先用 hermes proxy status 确认上游就绪。