Menu tài liệu

Tùy chọn bộ nhớ đệm và khắc phục sự cố

Các tùy chọn bộ nhớ đệm là một chuỗi nối ở cuối mật khẩu proxy. Các tùy chọn trong tên người dùng như pool, quốc gia, thành phố và phiên giữ nguyên. Hậu tố là toàn bộ thao tác bật: Litport không âm thầm bật bộ nhớ đệm cho một token, và yêu cầu không có hậu tố vẫn là yêu cầu proxy thông thường.

PASSWORD_cache-<types>[_cacheduration-<minutes>][_cacheignoreheader-1]

Ví dụ:

username:password_cache-images,fonts
username_country-us_sid-crawl-42:password_cache-all_cacheduration-30
username:password_cache-scripts_cacheduration-60_cacheignoreheader-1

Litport thử trước toàn bộ mật khẩu theo đúng nguyên văn. Cách này giữ nguyên mật khẩu hiện có tình cờ kết thúc bằng đoạn văn bản giống hậu tố bộ nhớ đệm. Chỉ khi thông tin đăng nhập chính xác đó không tồn tại, Litport mới phân tích chuỗi hậu tố bộ nhớ đệm hợp lệ ở cuối và xác thực mật khẩu gốc.

Tùy chọn#

Tùy chọn Giá trị Hành vi
_cache- images, scripts, fonts, all, một phần mở rộng được hỗ trợ, hoặc nhiều giá trị cách nhau bằng dấu phẩy Bật các loại đủ điều kiện. Giá trị không phân biệt hoa thường; giá trị do hệ thống tạo ra là chữ thường.
_cacheduration- Số phút nguyên, tối thiểu 1 Mặc định là 120 khi bỏ trống hoặc nhỏ hơn 1. Việc loại bỏ theo vận hành có thể xóa một mục sớm hơn.
_cacheignoreheader-1 Đúng giá trị 1 Bỏ qua các chỉ thị về độ mới và quyền riêng tư của máy chủ gốc đối với những phản hồi vốn đã đủ điều kiện. TTL được yêu cầu bắt đầu tính khi Litport nhận và lưu xong toàn bộ phản hồi; Date và Age của máy chủ gốc không bị trừ vào đó. Các trường hợp loại trừ an toàn tuyệt đối vẫn được áp dụng.

Các phần mở rộng là png,jpg,jpeg,gif,svg,ico,webp, js,css,wasm,map và woff,woff2,ttf,eot,otf. Danh sách trống hoặc giá trị không được hỗ trợ khiến yêu cầu không được lưu đệm mà không ảnh hưởng đến xác thực proxy.

Kết quả của yêu cầu#

HTTPS GET đủ điều kiện?Loại tệp đã chọn, yêu cầu an toàn, đã bật chế độ bộ nhớ đệm
HitPhục vụ nội dung cục bộByte từ bộ nhớ đệm miễn phí
MissLấy từ máy chủ gốc đã xác minhThu phí bình thường; lưu nếu có thể lưu đệm
BypassKhông an toàn hoặc không thể lưu đệmProxy và thu phí bình thường
Mỗi yêu cầu ở chế độ bộ nhớ đệm kết thúc bằng một lượt hit, miss hoặc bypass. Chỉ những byte thực sự được trả từ nội dung đã lưu đệm là miễn phí.
  • Hit: các byte nội dung phản hồi được trả từ mục trên hub là miễn phí. Việc client hủy giữa chừng hoặc lỗi đọc bộ nhớ đệm vẫn hiện ở trạng thái phân phối và không bao giờ bị chuyển thành lưu lượng bị tính phí.
  • Miss: Litport mở đường upstream thông thường. Các byte của yêu cầu và phản hồi bị tính phí bình thường. Một phản hồi đầy đủ, hợp lệ có thể được lưu cho yêu cầu khác.
  • Bypass: Litport gửi yêu cầu lên upstream mà không dùng hay lưu mục bộ nhớ đệm nào. Lưu lượng bị tính phí bình thường.

Litport không có header phản hồi riêng hay có thẩm quyền để báo cache hit. Age có thể xuất hiện hoặc tăng trên phản hồi đã lưu đệm, nhưng máy chủ gốc và CDN cũng có thể đặt nó; hãy dùng Thống kê lưu lượng hoặc API token để xem số lượt hit, miss, bypass, số byte miễn phí và khoản tiết kiệm trả theo GB. Không có chức năng xóa bộ nhớ đệm thủ công.

Điều kiện đủ và các trường hợp loại trừ tuyệt đối#

Litport chỉ lưu các phản hồi GET HTTPS có trạng thái 200 và đường dẫn kết thúc bằng phần mở rộng đã chọn. URL chính xác, gồm cả thứ tự và cách mã hóa của chuỗi truy vấn, xác định đối tượng. Ở chế độ tiêu chuẩn, s-maxage ghi đè max-age; giá trị ngắn hơn giữa độ mới hợp lệ của máy chủ gốc và thời lượng được yêu cầu sẽ được chọn. Thời lượng được yêu cầu là mức tối đa cứng: khi một phản hồi từ máy chủ gốc ở chế độ tiêu chuẩn đã có Age đã hiệu chỉnh bằng hoặc lớn hơn mức đó, Litport không lưu phản hồi ấy. Với _cacheignoreheader-1, TTL được yêu cầu bắt đầu tính khi Litport nhận và lưu xong toàn bộ phản hồi, không trừ Date hay Age của máy chủ gốc.

Các yêu cầu sau luôn bypass bộ nhớ đệm, kể cả với _cacheignoreheader-1:

  • Authorization, Cookie, Range hoặc các header yêu cầu có điều kiện
  • Cache-Control: no-cache, no-store hoặc max-age=0 của yêu cầu, hoặc Pragma: no-cache
  • Set-Cookie, Vary không được hỗ trợ, nội dung một phần, phản hồi quá lớn hoặc nội dung chưa đầy đủ
  • service worker, URL không có phần mở rộng, API, tài liệu, video, âm thanh và tệp nén
  • đích http:// thuần, đầu vào SOCKS5, UDP và HTTP/3/QUIC

_cacheignoreheader-1 có thể ghi đè các chỉ thị bộ nhớ đệm của phản hồi bị thiếu hoặc đang chặn, nhưng không ghi đè danh sách ở trên. Vì một mục đã lưu được chia sẻ trên một hub, chỉ dùng tùy chọn này cho các tài nguyên công khai không cần xác thực và giống hệt nhau với mọi bên yêu cầu.

Hành vi theo giao thức#

Client HTTP/1.1 và HTTP/2 được hỗ trợ cho các yêu cầu HTTPS ở chế độ bộ nhớ đệm. Litport cũng có thể thương lượng HTTP/2 ở chặng tới máy chủ gốc đã được xác minh. HTTP/3 dùng QUIC qua UDP, trong khi đường proxy HTTP tường minh của Litport là TCP CONNECT; vì vậy yêu cầu QUIC không đi vào đường bộ nhớ đệm này. Các ứng dụng thường quay về HTTP/2, nhưng Litport không cam kết lưu đệm cho HTTP/3.

Endpoint proxy của Litport có thể được viết là http://HUB:PORT. Việc đủ điều kiện dựa trên URL đích, phải là https://....

Khắc phục sự cố#

Triệu chứng Nguyên nhân có thể Cần làm
Lỗi TLS về bên cấp chứng chỉ hoặc CA không xác định Tiến trình client không tin cậy chứng chỉ gốc của Litport Cấu hình CA trong tiến trình đó; kiểm tra vân tay đã tải xuống.
Chạy được khi không có _cache-, lỗi khi có Kho tin cậy riêng của ứng dụng hoặc ghim chứng chỉ Cấu hình ứng dụng do bạn sở hữu, hoặc không dùng chế độ bộ nhớ đệm. Không thể vượt qua việc ghim chứng chỉ của bên thứ ba.
Yêu cầu đầu tiên bị tính phí Hub đã chọn đang trống Lặp lại đúng URL đủ điều kiện đó qua cùng hub.
Yêu cầu trở lại trống sau khi đổi hub Bộ nhớ đệm lưu cục bộ, không được sao chép Làm nóng hub mới hoặc dùng một hub cho khối lượng công việc đó.
Yêu cầu nào cũng là miss URL/truy vấn khác nhau, mục đã hết hạn hoặc bị loại, hoặc phản hồi không thể lưu So sánh URL chính xác, và kiểm tra header bộ nhớ đệm cùng trạng thái của máy chủ gốc.
Phản hồi từ máy chủ gốc có vẻ còn mới nhưng không được lưu ở chế độ tiêu chuẩn Age đã hiệu chỉnh của nó đã bằng hoặc lớn hơn thời lượng được yêu cầu Yêu cầu thời lượng dài hơn khi phù hợp, dùng phản hồi còn độ mới, hoặc dùng tùy chọn ghi đè nâng cao chỉ cho tài nguyên công khai không cần xác thực.
Phản hồi đã lưu đệm bị cũ hoặc cần thay đổi ngay Không có chức năng xóa bộ nhớ đệm thủ công Dùng TTL ngắn hơn hoặc URL có phiên bản, rồi chờ mục hết hạn.
Yêu cầu là bypass Phương thức, header, phản hồi, lược đồ đích, đầu vào hoặc phần mở rộng bị loại trừ Dùng GET HTTPS công khai đủ điều kiện, hoặc tiếp tục dùng proxy thông thường có tính phí.
HTTP thuần không bao giờ được lưu đệm Chặng tới máy chủ gốc của nó không có tính toàn vẹn được xác thực Cứ dùng bình thường; CA không thể làm cho HTTP thuần đủ điều kiện.

Với các đích nhạy cảm về lớp truyền tải, hãy đọc Bộ nhớ đệm và dấu vân tay truyền tải.