Menu tài liệu

Tham chiếu lỗi proxy

Lỗi proxy là các lỗi ở mặt phẳng dữ liệu từ đầu vào HTTP hoặc SOCKS5. Chúng tách biệt với các lỗi JSON do API Litport trả về.

Lỗi proxy HTTP#

Với đầu vào HTTP, hãy kiểm tra các header phản hồi này trước khi diễn giải trạng thái HTTP:

X-Proxy-Error-Code: 10
X-Proxy-Error-Message: Too many requests

Header dạng số là yếu tố phân biệt chính. Riêng trạng thái HTTP là chưa đủ: một số đường tương thích dùng 500, trong khi một số lỗi mạng được suy ra là 503. Mã 11 và 12 có thể kèm thông báo cụ thể hơn thông báo mặc định bên dưới.

Mã 13 (số dư tài khoản không đủ) là ngoại lệ so với quy ước 500: nó trả về 402 Payment Required. Nhiều client chỉ báo dòng trạng thái khi một đường hầm HTTPS thất bại, nên chỉ riêng trạng thái đã cho họ biết vấn đề nằm ở số dư. Hãy nạp thêm số dư trước khi thử lại.

Mã Ký hiệu Thông điệp mặc định hoặc trên đường truyền Trạng thái HTTP Hướng dẫn thử lại Cần làm gì
0 ErrorNone Trống Không có phản hồi lỗi Không áp dụng Coi yêu cầu là thành công.
1 ErrorPanic panic 500 Không thử lại liên tục Thử lại một lần có giãn cách, rồi liên hệ hỗ trợ kèm bằng chứng về yêu cầu.
2 ErrorInternal Internal proxy error 500 hoặc 503 Giãn cách thử lại có giới hạn Thử lại một số lần giới hạn, rồi liên hệ hỗ trợ.
3 ErrorInterrupted Connection was interrupted 500 Chỉ khi thao tác của ứng dụng an toàn Kiểm tra thời gian chờ của client và đích trước khi thử lại.
4 ErrorNoToken Token not found 407 Sau khi sửa thông tin đăng nhập Kiểm tra tên người dùng, mật khẩu, host và cổng của proxy.
5 ErrorNoAccess Access denied 500 để tương thích Không tự động thử lại Kiểm tra trạng thái token, quyền truy cập tài khoản và chính sách đích.
6 ErrorLimited You have reached the limit of concurrent connections 403 Sau khi có đủ dung lượng Đóng các kết nối nhàn rỗi hoặc giảm số kết nối đồng thời.
7 ErrorNoProxy Internal proxy error 500 Giãn cách thử lại có giới hạn Thử lại trong thời gian ngắn; liên hệ hỗ trợ nếu không có upstream nào khả dụng.
8 ErrorHubMismatch Proxy host mismatch, check token settings 500 Sau khi sửa hub Dùng hub hiển thị cho token trong bảng điều khiển.
9 ErrorHubProxyTypeMismatch Proxy type mismatch, check token settings 500 Sau khi sửa đầu vào Dùng endpoint HTTP hoặc SOCKS5 hiện tại của token.
10 ErrorRateLimited Too many requests 403 Cần giãn cách thử lại Giảm tần suất yêu cầu mới hoặc kết nối mới cho chế độ đầu vào.
11 ErrorPpgGetProxy PPG proxy error Có thể được thay bằng một thông điệp cụ thể trên đường truyền. 500 Tùy thuộc vào thông điệp tùy chỉnh Sửa tham số pool, vị trí hoặc phiên; nếu không, hãy thử lại có giãn cách.
12 ErrorPpgStats PPG stats error Thông điệp trên đường truyền có thể là tùy chỉnh. 500 Giãn cách thử lại có giới hạn Thử lại trong thời gian ngắn, rồi liên hệ hỗ trợ nếu lỗi vẫn tiếp diễn.
13 ErrorPpgNotEnoughUnits Insufficient account balance 402 Thử lại kết nối không giúp ích Kiểm tra hoặc nạp thêm số dư tài khoản trong bảng điều khiển.
14 ErrorRemoteProxy Remote proxy connection error 500 hoặc 503 Giãn cách thử lại có giới hạn Thử lại có giãn cách; lần thử lại có thể chọn một proxy từ xa khác. Nếu bạn chọn theo quốc gia, vùng hoặc thành phố và lỗi vẫn tiếp diễn, vị trí đó có thể hiện chưa có IP nào trực tuyến: hãy thử lại sau hoặc mở rộng vị trí.
15 ErrorUpstreamConnection Upstream server connection error 500 hoặc 503 Tùy thuộc vào độ an toàn của đích Kiểm tra đích và chính sách thử lại trước khi thử lại.
16 ErrorPpgUpstreamResponse Internal proxy error 500 Giãn cách thử lại có giới hạn Thử lại trong thời gian ngắn; nếu vẫn tiếp diễn, hãy liên hệ hỗ trợ kèm hub, ID token, đích, dấu thời gian và mã 16, không bao giờ gửi mật khẩu proxy.
17 ErrorPackageBandwidthExceeded packageBandwidthExceeded 403 Thử lại kết nối không giúp ích Chỉ gói cũ có hạn mức lưu lượng mới gặp lỗi này: gói đã dùng hết lưu lượng của kỳ hiện tại. Hãy chờ kỳ gia hạn hoặc liên hệ hỗ trợ.
18 ErrorPackageEntitlementUnavailable packageEntitlementUnavailable 503 Giãn cách thử lại có giới hạn Không đọc hoặc giữ được quyền lợi của gói kịp thời. Thử lại trong thời gian ngắn; nếu vẫn tiếp diễn, hãy liên hệ hỗ trợ kèm hub, ID token và dấu thời gian.
19 ErrorPackageInactive packageInactive 403 Không tự động thử lại Gói đang bị tạm ngưng hoặc đã hủy. Kiểm tra trạng thái và phương thức thanh toán của gói trong bảng điều khiển.
20 ErrorPackageExpired packageExpired 403 Không tự động thử lại Kỳ của gói đã kết thúc. Hãy gia hạn hoặc mua gói mới trong bảng điều khiển.
21 ErrorPackageMissing packageMissing 403 Không tự động thử lại Token trỏ tới một gói không còn tồn tại. Liên hệ hỗ trợ kèm ID token.
22 ErrorPackageStale packageEntitlementStale 403 Không tự động thử lại Hub đang giữ bản ghi gói quá cũ để tin cậy. Liên hệ hỗ trợ kèm hub, ID token và dấu thời gian.
23 ErrorClientAborted Client closed the connection Không gửi (client đã đóng) Không áp dụng Client của bạn đã đóng hoặc đặt lại kết nối trước khi yêu cầu hoàn tất. Kiểm tra thời gian chờ của client và việc tái sử dụng kết nối.
24 ErrorPpgAllowanceExceeded Traffic allowance used up 403 Thử lại kết nối không giúp ích Hạn mức lưu lượng của proxy này đã dùng hết. Chủ tài khoản có thể tăng hoặc bỏ hạn mức trong bảng điều khiển hoặc qua API.
25 ErrorPpgAllowanceUnavailable Traffic allowance unavailable 503 Giãn cách thử lại có giới hạn Không đọc hoặc giữ được hạn mức lưu lượng của proxy này kịp thời. Thử lại trong thời gian ngắn; nếu vẫn tiếp diễn, hãy liên hệ hỗ trợ kèm hub, ID token và dấu thời gian.

Với token Di động dùng chung có “Đa vị trí”, mã 7 kèm thông báo noHealthyRoute nghĩa là đích đã lưu hiện không có thiết bị nào hoạt động tốt. Đọc vị trí của token, rồi chờ phục hồi hoặc chọn một đích khả dụng khác. Thành phố luôn được giữ: nhà mạng không có điện thoại nào hoạt động trong thành phố đó sẽ chuyển sang nhà mạng khác trong cùng thành phố, và effective cho biết nhà mạng thực tế đang dùng.

TLS handshake thất bại với endpoint proxy HTTP https:// hiện ra dưới dạng kết nối bị đóng trước khi có bất kỳ phản hồi HTTP nào được gửi, nên không có X-Proxy-Error-Code để kiểm tra. Nếu một kết nối https:// đóng ngay lập tức, hãy kiểm tra lược đồ URL, hostname (không phải địa chỉ IP), và việc client tin cậy chứng chỉ gốc bộ nhớ đệm của Litport cho kết nối proxy.

Lỗi upstream của PPG#

Mã 16 nghĩa là một upstream trả theo GB không thể phục vụ yêu cầu. Nó không có nghĩa là đích đã trả về 500 của Litport. Mã 14 nghĩa là proxy từ xa từ chối hoặc ngắt kết nối, ví dụ vì không có IP nào trực tuyến ở vị trí được nhắm tới. Trong cả hai trường hợp, Litport cố ý thay trạng thái, header và nội dung của nhà cung cấp upstream bằng lỗi cố định của riêng mình.

Client HTTP nên rẽ nhánh theo X-Proxy-Error-Code: 16, không chỉ theo trạng thái HTTP. Client SOCKS5 nhận lỗi chung mà không có header dạng số; chỉ tái hiện một yêu cầu an toàn, idempotent qua đầu vào HTTP của token để xem mã Litport.

Hãy thử lại với giãn cách thử lại có giới hạn. Nếu lỗi còn kéo dài, liên hệ hỗ trợ kèm hub, ID token, đích, dấu thời gian và mã 16—không bao giờ kèm mật khẩu proxy. Lưu lượng trao đổi sau khi được chấp nhận, gồm cả phản hồi lỗi chung, vẫn tuân theo chính sách sử dụng hiện hành.

Lỗi giới hạn lưu lượng#

Proxy trả theo GB có thể có giới hạn lưu lượng. Chỉ proxy có giới hạn mới gặp mã 24 và 25.

Mã 24 nghĩa là proxy đã dùng hết giới hạn. Đây là HTTP 403. Thử lại không giúp ích: chủ tài khoản phải nâng hoặc gỡ giới hạn, trong bảng điều khiển hoặc qua API. Khi đó disabledReason của token là allowance.

Mã 25 nghĩa là không đọc hoặc không giữ được giới hạn kịp thời. Đây là HTTP 503. Hãy thử lại trong thời gian ngắn với giãn cách thử lại có giới hạn. Nếu lỗi còn kéo dài, liên hệ hỗ trợ kèm hub, ID token và dấu thời gian.

Khi chủ tài khoản thêm, đổi hoặc gỡ giới hạn, các kết nối đang mở của proxy kết thúc một lần. Client kết nối lại theo giới hạn mới.

Phản hồi SOCKS5#

SOCKS5 không có X-Proxy-Error-Code hay X-Proxy-Error-Message. Nhiều nhóm lỗi nội bộ được cố ý gộp thành một phản hồi.

Hầu hết các kiểm tra token và tài khoản, gồm cả số dư không đủ, chạy trong lúc đăng nhập bằng tên người dùng/mật khẩu, trước khi client gửi yêu cầu. Lỗi ở đó đóng kết nối như một lần đăng nhập bị từ chối, và hầu hết client báo đó là lỗi xác thực dù mật khẩu đúng.

Phản hồi Ý nghĩa Các nhóm có thể có
auth 0x01 Đăng nhập bị từ chối Bước tên người dùng/mật khẩu (RFC 1929) thất bại và kết nối bị đóng trước mọi yêu cầu. Hầu hết kiểm tra token và tài khoản diễn ra ở đây: token không xác định, bị vô hiệu hóa hoặc hết hạn, hoặc sai mật khẩu (4), token không khớp quyền truy cập (5), sai hub (8) hoặc giao thức (9), tham số pool PPG không hợp lệ (11), ghi nhận lưu lượng PPG (12), số dư không đủ (13), trạng thái gói (17–22) và giới hạn lưu lượng proxy (24–25). Client thường báo đây là lỗi xác thực.
0x01 Lỗi chung Lỗi nội bộ, hoặc kết nối upstream thất bại sau khi yêu cầu được chấp nhận. Thường là mã 2, 14, 15 hoặc 16.
0x02 Kết nối không được phép Yêu cầu bị từ chối sau khi đăng nhập: quy tắc đích hoặc mạng (5), giới hạn kết nối đồng thời (6), không có upstream khả dụng (7), giới hạn tần suất (10), chọn upstream PPG (11), hoặc UDP PPG mà upstream đã chọn không hỗ trợ.
0x07 Lệnh không được hỗ trợ Lệnh SOCKS5 được yêu cầu chưa được triển khai; đây không phải X-Proxy-Error-Code.

Để phân biệt, hãy tái hiện cùng một yêu cầu an toàn, idempotent với cùng thông tin đăng nhập qua đầu vào HTTP tương ứng, rồi xem các header của nó. Nếu việc tái hiện sẽ lặp lại một tác dụng phụ hoặc không an toàn, đừng tái hiện.

Chính sách thử lại an toàn#

  1. Sửa thông tin đăng nhập, hub, giao thức, vị trí, số dư hoặc số kết nối đồng thời của client trước khi thử lại các lỗi có tính xác định.
  2. Thử lại các lỗi tạm thời ở nội bộ, ở khâu chọn và ở upstream bằng giãn cách thử lại lũy thừa có giới hạn và jitter.
  3. Chỉ thử lại một thao tác ứng dụng bị gián đoạn hoặc ở upstream khi việc lặp lại thao tác đó là an toàn.
  4. Không bao giờ chạy vòng lặp thử lại dồn dập. Giữ lại bằng chứng đầu tiên và cuối cùng của một chuỗi có giới hạn.

Bằng chứng cho hỗ trợ#

Hãy gửi kèm hub Litport, đầu vào HTTP hoặc SOCKS5, dấu thời gian UTC, ID token, host và cổng đích, cùng mã/thông báo lỗi quan sát được hoặc phản hồi SOCKS5. Gửi cả phương thức yêu cầu khi liên quan.