พร็อกซีสมาชิก — เกตเวย์ที่ใช้ร่วมกัน
พร็อกซีสมาชิก — เกตเวย์ที่ใช้ร่วมกัน — คู่มือที่เข้าใจง่ายอ้างอิงจากเอกสารทางการ
ลองนึกภาพเหมือนการเป็นสมาชิกฟิตเนส: คุณคงไม่ยื่นบัตรจริงให้เพื่อนยืมแล้วเสี่ยงที่จะทำหายใช่ไหม? แต่คุณจะให้บัตรผ่านเข้าชม (guest pass) แทน Subscription Proxy ก็คือบัตรผ่านเข้าชมสำหรับการสมัครสมาชิก AI ของคุณนั่นเอง
ปัญหาที่มันแก้ให้
แอป 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