第42篇:訂閱代理——訂閱共享閘道
Hermes 功能詳解第42篇:Subscription Proxy。訂閱服務共享代理。
這篇講的是:如何把你 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 中樞。
📖 官方文档
本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › user-guide/features/subscription-proxy