第42篇：订阅代理——订阅共享网关

这篇讲的是：如何把你 Hermes 里已经登录好的 AI 订阅（比如 Nous Portal），变成一个“本地插座”，让其他任何 AI 应用都能插上来用，而不用再单独买 API key。

先打个比方

想象你办了一张高级健身房会员卡（Portal 订阅）。以前只有你自己能刷脸进。现在 Hermes 给你发了一个“门禁转发器”（订阅代理），放在你家门口（本地服务器）。任何朋友（其他 AI 应用）只要走到门口，报个名字（随便填个 key），门禁就自动用你的会员卡帮他们开门。他们自己不需要办卡。

第1步：登录你的订阅（只做一次）

打开终端，运行：

hermes portal

浏览器会弹出登录窗口，完成授权。Hermes 会把“刷新令牌”存在 ~/.hermes/auth.json 里，以后自动续期，不用管。

第2步：启动订阅代理

hermes proxy start

看到类似输出就成功了：

Starting Hermes proxy for Nous Portal
  Listening on:  http://127.0.0.1:8645/v1
  Forwarding to: (resolved per-request from your subscription)
  Use any bearer token in the client — the proxy attaches your real credential.

这个窗口别关。想让它后台跑，可以用 tmux 或 nohup。

第3步：让其他应用连上来

任何支持 OpenAI 格式的应用，都填这三样：

Base URL:   http://127.0.0.1:8645/v1
API key:    随便填，比如 "sk-unused"
Model:      Hermes-4-70B    # 或 Hermes-4.3-36B / Hermes-4-405B

代理会忽略你填的 key，自动换成你真实的 Portal 凭证，快过期时还会自动刷新。

检查状态

hermes proxy status

看到 ready 就正常。如果提示 not logged in，重新跑 hermes portal；如果提示 credentials need attention，说明刷新令牌被吊销了（比如你在网页端登出过），重新登录即可。

具体配置示例

给 OpenViking（记忆数据库）用：

编辑 ~/.openviking/ov.conf：

{
  "vlm": {
    "provider": "openai",
    "model": "Hermes-4-70B",
    "api_base": "http://127.0.0.1:8645/v1",
    "api_key": "unused-proxy-attaches-real-creds"
  }
}

然后开两个终端：

# 终端1
hermes proxy start

# 终端2
openviking-server

给 Karakeep（书签摘要）用：

在它的 .env 里写：

OPENAI_API_BASE_URL=http://127.0.0.1:8645/v1
OPENAI_API_KEY=any-non-empty-string
INFERENCE_TEXT_MODEL=Hermes-4-70B

Open WebUI、LobeChat、NextChat 等也都是一样套路。

想给局域网其他电脑用？

hermes proxy start --host 0.0.0.0 --port 8645

⚠️ 注意：代理本身不设防，谁连上都能用你的订阅额度。 只建议在可信网络里开，或者套个带密码的反向代理。

额度怎么算？

代理不合并、不分配，所有请求都走你同一个订阅的 RPM/TPM 限额。用量去 portal.nousresearch.com 看。

小总结

订阅代理 = 把“登录好的订阅”变成“本地 OpenAI 兼容接口”。它只转发请求、自动附带真实凭证，不做任何加工。适合“只想用模型、不需要 agent 工具”的场景。如果你想要 Hermes 的完整智能体能力（工具、记忆、技能），那应该用 API server，那是另一篇的故事了。

下篇预告：第43篇，我们来聊聊怎么把 Hermes 的 API server 和订阅代理组合起来，搭一个“既能聊天又能干活”的家庭 AI 中枢。