🤖HermesBlog
Hermes 功能詳解 · 第42篇2026/8/9· Easy Understand Hermes Agent

第42篇:訂閱代理——訂閱共享閘道

Hermes 功能詳解第42篇:Subscription Proxy。訂閱服務共享代理。

這篇講的是:如何把你 Hermes 裡已經登入好的 AI 訂閱(比如 Nous Portal),變成一個「本地插座」,讓其他任何 AI 應用都能插上來用,而不用再單獨買 API key。


hermes-feature-42-subscription-proxy

先打個比方

想像你辦了一張高級健身房會員卡(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.

這個視窗別關。想讓它在背景跑,可以用 tmuxnohup


第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 中樞。


📖 官方文档

本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › user-guide/features/subscription-proxy