Proxy Đăng ký — Cổng dùng chung

Hãy nghĩ về nó như một thẻ thành viên phòng gym: bạn sẽ không đưa chiếc thẻ thật của mình cho bạn bè vì sợ mất. Thay vào đó, bạn sẽ lấy cho họ một thẻ khách. Subscription Proxy chính là tấm thẻ khách đó cho các gói đăng ký AI của bạn.

Vấn Đề Mà Nó Giải Quyết

Nhiều ứng dụng AI — như OpenViking hay Open WebUI — sử dụng định dạng API của OpenAI. Bạn có thể đưa trực tiếp khóa đăng ký Nous Portal của mình cho chúng, nhưng điều đó thật rủi ro (chúng có thể làm lộ khóa) và phiền phức (khóa sẽ hết hạn). Proxy giải quyết vấn đề này bằng cách chạy một máy chủ cục bộ nhỏ. Mọi yêu cầu từ ứng dụng của bạn đều đi qua nó, và proxy tự động gắn thông tin đăng nhập thật của bạn vào. Các ứng dụng của bạn có thể dùng bất kỳ khóa giả nào — proxy sẽ thay thế bằng khóa thật ở hậu trường.

Điểm Khác Biệt So Với API Server

	API Server	Subscription Proxy
Chức năng cung cấp	Các agent Hermes đầy đủ (công cụ, bộ nhớ, kỹ năng)	Suy luận mô hình thuần túy
Phù hợp nhất cho	“Dùng Hermes làm backend trò chuyện”	“Chia sẻ gói đăng ký Portal của bạn với các ứng dụng khác”
Xác thực	Cần API_SERVER_KEY của bạn	Bất kỳ bearer token nào (proxy sẽ thay thế)
Gọi công cụ (Tool calling)	Được hỗ trợ	Không được hỗ trợ (chuyển tiếp thuần túy)

Nói ngắn gọn: Hãy dùng API server khi bạn muốn một agent; hãy dùng proxy khi bạn chỉ muốn có mô hình.

Ba Bước Để Bắt Đầu

1. Đăng Nhập Một Lần

hermes portal

Một trình duyệt sẽ mở ra với trang ủy quyền Nous Portal. Sau khi bạn đăng nhập, Hermes sẽ lưu trữ refresh token trong ~/.hermes/auth.json.

2. Khởi Động Proxy

hermes proxy start

Bạn sẽ thấy kết quả như sau:

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.

Muốn chạy ngầm ở chế độ nền? Hãy dùng tmux, nohup, hoặc một dịch vụ systemd.

3. Cấu Hình Ứng Dụng Của Bạn

Bất kỳ ứng dụng nào tương thích với OpenAI chỉ cần ba cài đặt:

Base URL:   http://127.0.0.1:8645/v1
API key:    anything (e.g. "sk-unused")
Model:      Hermes-4-70B    # or Hermes-4.3-36B, Hermes-4-405B

Proxy sẽ bỏ qua bất kỳ khóa nào bạn nhập vào và thay thế nó bằng thông tin đăng nhập Portal thật của bạn — và tự động làm mới trước khi nó hết hạn.

Kiểm Tra Trạng Thái

hermes proxy status

Bạn muốn thấy trạng thái ready. Nếu nó báo not logged in, hãy chạy lại hermes portal. Nếu nó báo credentials need attention, refresh token của bạn đã bị thu hồi (thường là do bạn đã đăng xuất trên trang web Portal) — chỉ cần đăng nhập lại.

Các Endpoint Được Hỗ Trợ

Proxy chỉ chuyển tiếp các đường dẫn mà máy chủ gốc thực sự hỗ trợ; mọi thứ khác sẽ trả về mã 404 với thông báo rõ ràng:

Đường dẫn	Mục đích
/v1/chat/completions	Hoàn thành hội thoại (hỗ trợ phát trực tuyến)
/v1/completions	Hoàn thành văn bản (legacy)
/v1/embeddings	Vector nhúng
/v1/models	Liệt kê các mô hình có sẵn

Tóm Tắt & Mẹo Thực Tế

Subscription proxy là một bộ điều hợp an toàn: nó cho phép các ứng dụng khác dùng chung gói đăng ký của bạn mà không bao giờ làm lộ khóa thật, và nó tự động xử lý việc hết hạn. Hiện tại, nó hỗ trợ Nous Portal và xAI (Grok), với nhiều nhà cung cấp khác sẽ sớm được bổ sung.

Một mẹo thực tế: Nếu bạn dùng nhiều ứng dụng, hãy cấp cho mỗi ứng dụng một khóa giả khác nhau (ví dụ sk-app1, sk-app2). Bằng cách đó, nhật ký proxy sẽ hiển thị chính xác ứng dụng nào đang gửi yêu cầu nào — giúp việc gỡ lỗi dễ dàng hơn nhiều. Ngoài ra, proxy chỉ lắng nghe trên 127.0.0.1 theo mặc định. Đừng đổi nó thành 0.0.0.0, nếu không bất kỳ thiết bị nào trong mạng của bạn cũng có thể sử dụng gói đăng ký của bạn.

---