Cài Gateway Agent trên PC hoặc VPS

Gateway Agent là chương trình nhỏ chạy nền trên máy của bạn. Nó giữ kết nối tới RexAPF, nhận lệnh từ Agent trong hội thoại, thực thi trong thư mục workspace rồi gửi kết quả về.

#Cách hoạt động

• Agent kết nối tới máy chủ qua SSE và gửi heartbeat định kỳ (mặc định 30 giây).
• Khi Agent trên RexAPF Web gửi lệnh, Gateway thực thi trên máy rồi gửi kết quả lại.
• Mất kết nối, Gateway tự kết nối lại với thời gian chờ tăng dần.
• Mọi giao tiếp dùng token Gateway dạng gw_… trong header Authorization: Bearer.

Token Gateway khác khoá API sk_9r_…. Token gw_ chỉ dùng để máy của bạn kết nối, không dùng để gọi model.

#Lấy token và lệnh cài

1. Tạo Local PC Gateway

   Trên RexAPF Web, mở Tuỳ biến › Kết nối, chọn Local PC Gateway, nhập Tên máy, chọn quyền rồi nhấn Tạo token & tiếp tục. Chi tiết ở Kết nối.

2. Sao chép lệnh cài

   Ở bước Cài đặt, chọn tab hệ điều hành và nhấn Sao chép. Lệnh đã kèm token và địa chỉ máy chủ.

3. Chạy lệnh trên máy cần kết nối

   Dán lệnh vào terminal của PC hoặc phiên SSH tới VPS:

   macOS / LinuxWindows (PowerShell)Sao chép

   $ curl -sL https://rexapf.com/scripts/setup-gateway.sh | bash -s -- "gw_..." "https://rexapf.com"

4. Xác minh

   Quay lại hộp thoại trên RexAPF Web. Khi Gateway phản hồi, bước Xác minh hiện quyền, khả năng và thư mục workspace.

#Trình cài đặt làm gì

Trên macOS và Linux, setup-gateway.sh:

1. Kiểm tra Node.js 20+, curl và tar.
2. Tải gói Gateway, kiểm tra mã SHA-256 và manifest trước khi giải nén.
3. Cài vào ~/.rexllm-gateway, tạo workspace (mặc định ~/rexllm-workspace).
4. Ghi tệp .env (quyền 600) chứa token, địa chỉ máy chủ và workspace.
5. Thử cài Chromium cho tự động hoá trình duyệt.
6. Đăng ký dịch vụ nền: LaunchAgent com.rexllm.gateway trên macOS, systemd user unit rexllm-gateway.service trên Linux.

Khi cập nhật, trình cài giữ lại .env và spool cũ, rồi tự khôi phục bản trước nếu bản mới không chạy được.

Trên Windows, setup-gateway.ps1 cài vào %USERPROFILE%\.rexllm-gateway và đăng ký scheduled task RexllmGatewayAgent chạy khi đăng nhập, tự khởi động lại khi lỗi.

$ curl -sL https://rexapf.com/scripts/setup-gateway.sh | bash -s -- "gw_..." "https://rexapf.com"
📥 Downloading and verifying Gateway Agent from https://rexapf.com ...
📦 Installing Gateway runtime dependencies...
🌐 Installing Chromium for browser automation...
⚙️  Installing or refreshing the background service...

✅ Gateway Agent is installed, running, and validated (version 0.2.1).
   Installation: /home/ubuntu/.rexllm-gateway
   Workspace:    /home/ubuntu/rexllm-workspace
   Server:       https://rexapf.com
   Status:       Background service active.

#Cài trên VPS

Lệnh macOS / Linux chạy được trên VPS Linux qua SSH. Lưu ý:

• Trình cài bật loginctl enable-linger cho user hiện tại, để dịch vụ systemd vẫn chạy sau khi bạn thoát SSH và sau khi khởi động lại máy.
• Để chọn workspace khác, thêm đường dẫn làm đối số thứ ba:

$ curl -sL https://rexapf.com/scripts/setup-gateway.sh | bash -s -- "gw_..." "https://rexapf.com" "/srv/rexapf-workspace"

• Kiểm tra dịch vụ bằng systemctl --user status rexllm-gateway.service.

#Quyền mặc định

Lệnh init mà trình cài gọi ghi .env với mọi quyền bật để dùng được ngay:

Gateway chỉ thao tác file trong WORKSPACE_DIR. Bạn có thể thu hẹp quyền ở Mở cài đặt trên thẻ Gateway của RexAPF Web, hoặc sửa .env rồi khởi động lại dịch vụ.

#Lệnh quản lý

Chạy trong thư mục cài đặt ~/.rexllm-gateway:

$ node src/index.js status              # kiểm tra nhanh dịch vụ, cấu hình, quyền
$ node src/index.js doctor              # chẩn đoán đầy đủ
$ node src/index.js install-browser     # cài Playwright + Chromium
$ node src/index.js service uninstall   # gỡ dịch vụ nền
$ node src/index.js --version

Trên macOS và Linux, nhật ký dịch vụ ghi vào ~/.rexllm-gateway/gateway.log. Trên Windows, gỡ scheduled task bằng Unregister-ScheduledTask -TaskName RexllmGatewayAgent -Confirm:$false.

#Liên quan