API HTTP cấu hình cục bộ
Chỉ trên máy tính: kiểm tra và xem trước cấu hình Xray từ công cụ của riêng bạn.
Bật
Mở Xray → API cục bộ và bật Bật API cục bộ. API chỉ lắng nghe trên 127.0.0.1, mặc định cổng 18587. Dùng Sao chép token để đưa token truy cập cho công cụ tin cậy; Đặt lại token thu hồi token cũ.
Yêu cầu
Mọi yêu cầu đều cần Authorization: Bearer <token>.
| Yêu cầu | Kết quả |
|---|---|
GET /api/v1/info | Phiên bản API, ứng dụng, lõi và nền tảng |
POST /api/v1/config/validate | Kiểm tra một cấu hình |
POST /api/v1/config/compile | Xem trước cấu hình chạy thực tế mà Tunnix sẽ tạo |
Nội dung POST là JSON gồm kind (outbound, routing, advanced-routing hoặc raw) và text là JSON gốc dạng chuỗi.
curl -s http://127.0.0.1:18587/api/v1/info \
-H "Authorization: Bearer $TUNNIX_TOKEN"
Giới hạn
API không nhập, lưu hay chọn máy chủ và không bật/tắt được VPN. HTTP 200 với status: failed nghĩa là yêu cầu đã chạy nhưng cấu hình không đạt.
Đừng bao giờ đưa token vào URL, lịch sử dòng lệnh hay prompt AI. Ai có token đều dùng được API trên máy tính này.