🤖HermesBlog
คู่มือฟีเจอร์ของ Hermes · Parte 428/9/2026

พร็อกซีสมาชิก — เกตเวย์ที่ใช้ร่วมกัน

พร็อกซีสมาชิก — เกตเวย์ที่ใช้ร่วมกัน — คู่มือที่เข้าใจง่ายอ้างอิงจากเอกสารทางการ

ลองนึกภาพเหมือนการเป็นสมาชิกฟิตเนส: คุณคงไม่ยื่นบัตรจริงให้เพื่อนยืมแล้วเสี่ยงที่จะทำหายใช่ไหม? แต่คุณจะให้บัตรผ่านเข้าชม (guest pass) แทน Subscription Proxy ก็คือบัตรผ่านเข้าชมสำหรับการสมัครสมาชิก AI ของคุณนั่นเอง

hermes-feature-42-subscription-proxy

ปัญหาที่มันแก้ให้

แอป AI หลายตัว — อย่าง OpenViking หรือ Open WebUI — พูดภาษา OpenAI API format คุณอาจจะให้คีย์การสมัครสมาชิก Nous Portal ของคุณโดยตรงกับพวกมันได้ แต่นั่นมันเสี่ยง (พวกมันอาจทำคีย์รั่วไหล) และน่ารำคาญ (คีย์หมดอายุ) ตัว proxy แก้ปัญหานี้ด้วยการรันเซิร์ฟเวอร์ขนาดเล็กในเครื่องของคุณ ทุกคำขอจากแอปของคุณจะผ่าน proxy นี้ และ proxy จะทำการแนบข้อมูลประจำตัวจริงของคุณให้อัตโนมัติ แอปของคุณสามารถใช้คีย์ปลอมอะไรก็ได้ — proxy จะสลับเป็นคีย์จริงให้เบื้องหลัง

ต่างจาก API Server อย่างไร

API Server Subscription Proxy
สิ่งที่ให้ เอเจนต์ Hermes เต็มรูปแบบ (เครื่องมือ, ความจำ, ทักษะ) การอนุมานโมเดลล้วน ๆ
เหมาะสำหรับ “ใช้ Hermes เป็นแบ็กเอนด์แชท” “แชร์การสมัครสมาชิก Portal ของคุณกับแอปอื่น”
การยืนยันตัวตน ต้องใช้ API_SERVER_KEY ของคุณ Bearer token อะไรก็ได้ (proxy จะแทนที่ให้)
การเรียกใช้เครื่องมือ (Tool calling) รองรับ ไม่รองรับ (เป็นเพียงตัวส่งผ่านข้อมูล)

สรุปในหนึ่งประโยค: ใช้ API server เมื่อคุณต้องการเอเจนต์; ใช้ proxy เมื่อคุณแค่อยากได้โมเดล

สามขั้นตอนในการเริ่มต้น

1. เข้าสู่ระบบหนึ่งครั้ง

hermes portal

เบราว์เซอร์จะเปิดขึ้นพร้อมกับหน้าให้อนุญาตของ Nous Portal หลังจากที่คุณเข้าสู่ระบบแล้ว Hermes จะเก็บ refresh token ไว้ใน ~/.hermes/auth.json

2. เริ่มต้น Proxy

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, หรือ systemd service

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

proxy จะไม่สนใจคีย์ที่คุณพิมพ์เข้าไป และจะแทนที่ด้วยข้อมูลประจำตัว Portal จริงของคุณ — และรีเฟรชให้อัตโนมัติก่อนที่มันจะหมดอายุ

ตรวจสอบสถานะ

hermes proxy status

คุณจะเห็นสถานะ ready หากขึ้นว่า not logged in ให้รัน hermes portal อีกครั้ง หากขึ้นว่า credentials need attention แสดงว่า refresh token ของคุณถูกเพิกถอน (มักเกิดจากการที่คุณออกจากระบบบนเว็บไซต์ Portal) — แค่เข้าสู่ระบบใหม่

เอ็นด์พอยต์ที่รองรับ

proxy จะส่งต่อเฉพาะเส้นทางที่ upstream รองรับจริงเท่านั้น; นอกนั้นจะคืนค่า 404 พร้อมข้อความที่ชัดเจน:

Path วัตถุประสงค์
/v1/chat/completions การสนทนาแบบสมบูรณ์ (รองรับการสตรีม)
/v1/completions การเติมข้อความแบบเดิม (legacy)
/v1/embeddings เวกเตอร์ฝังตัว (Embedding vectors)
/v1/models รายการโมเดลที่มีให้ใช้งาน

สรุปและเคล็ดลับการใช้งาน

Subscription proxy คืออะแดปเตอร์ที่ปลอดภัย: มันช่วยให้แอปอื่น ๆ แชร์การสมัครสมาชิกของคุณได้โดยไม่ต้องเปิดเผยคีย์จริงของคุณ และมันจัดการเรื่องการหมดอายุให้คุณเอง ปัจจุบันรองรับ Nous Portal และ xAI (Grok) โดยจะมีผู้ให้บริการรายอื่น ๆ เพิ่มเติมในอนาคต

เคล็ดลับการใช้งาน: หากคุณใช้หลายแอป ให้กำหนดคีย์ปลอมที่แตกต่างกันให้แต่ละแอป (เช่น sk-app1, sk-app2) วิธีนี้จะทำให้ log ของ proxy แสดงได้ชัดเจนว่าแอปไหนส่งคำขออะไร — ทำให้การดีบักง่ายขึ้นมาก อีกอย่าง proxy จะฟังเฉพาะที่ 127.0.0.1 โดยค่าเริ่มต้น อย่าเปลี่ยนเป็น 0.0.0.0 เป็นอันขาด ไม่เช่นนั้นอุปกรณ์อื่น ๆ ในเครือข่ายของคุณก็สามารถใช้การสมัครสมาชิกของคุณได้เช่นกัน


📖 เอกสารทางการ

この記事は Hermes Agent のเอกสารทางการに基づいています:เอกสารทางการ › user-guide/features/subscription-proxy