Menu tài liệu

Thiết lập chứng chỉ bộ nhớ đệm

Chọn một tùy chọn TLS cho chế độ bộ nhớ đệm#

Không có hậu tố mật khẩu _cache-? Không cần đổi gì. Chế độ proxy thông thường giữ TLS đầu cuối và không yêu cầu cài chứng chỉ hay thay đổi TLS của client cho endpoint proxy http:// thuần. Endpoint proxy https:// là ngoại lệ duy nhất: chứng chỉ hub của nó liên kết tới chính chứng chỉ gốc này, nên hãy tin cậy chứng chỉ gốc cho kết nối proxy như mô tả ở Endpoint proxy HTTP và HTTPS. Chỉ riêng việc tin cậy đó không bao giờ bật chế độ bộ nhớ đệm.

Khi chế độ bộ nhớ đệm đang bật, hãy chọn một trong hai:

Tùy chọn Xác minh chứng chỉ Phù hợp nhất cho
Tin cậy chứng chỉ gốc của Litport (Khuyến nghị) Bật Client bộ nhớ đệm dùng lâu dài và hồ sơ tự động hóa riêng
Bỏ qua xác minh chứng chỉ Tắt Tự động hóa dữ liệu công khai tách biệt, nơi bạn chấp nhận đánh đổi về bảo mật

Bỏ qua xác minh nghĩa là client không thể xác thực chứng chỉ của đích. Không bao giờ dùng tùy chọn đó cho đăng nhập, thanh toán, API riêng tư, cookie hay lưu lượng nhạy cảm.

URL proxy có thể bắt đầu bằng http:// vì nó xác định endpoint proxy HTTP. Đích vẫn là https://example.com/...; lược đồ của endpoint proxy và lược đồ của đích là hai thứ khác nhau.

Bỏ qua xác minh cho tự động hóa dữ liệu công khai tách biệt#

Chỉ dùng tùy chọn này trong một client bộ nhớ đệm riêng chuyên lấy dữ liệu tĩnh công khai. Nó tắt việc xác thực chứng chỉ đích của client; nó không làm cho việc đánh chặn lưu lượng riêng tư trở nên an toàn. Hãy giữ thông tin đăng nhập proxy trong kho bí mật và gỡ hậu tố bộ nhớ đệm khi khối lượng công việc tách biệt kết thúc.

curl#

curl --insecure --proxy 'http://hub-us-7.litport.net:PORT' \
  --proxy-user 'USER:PASSWORD_cache-scripts' \
  'https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js'

Python Requests#

import requests

requests.get(
    'https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js',
    proxies={'https': 'http://USER:[email protected]:PORT'},
    verify=False,
    timeout=30,
)

Node#

NODE_TLS_REJECT_UNAUTHORIZED=0 node scraper.mjs

Hãy cấu hình proxy HTTP trong tiến trình Node tách biệt đó. Thiết lập môi trường này tắt xác minh chứng chỉ cho tiến trình đó; không đặt nó cho dịch vụ đa dụng.

Tự động hóa trình duyệt#

import { chromium } from 'playwright'

const browser = await chromium.launch({ proxy: {
  server: 'http://hub-us-7.litport.net:PORT',
  username: 'USER',
  password: 'PASSWORD_cache-scripts',
}})
const context = await browser.newContext({ ignoreHTTPSErrors: true })
await (await context.newPage()).goto('https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js')

Dùng một hồ sơ trình duyệt riêng cho khối lượng công việc này. Không dùng nó để duyệt các trang đã đăng nhập hoặc nhạy cảm.

Go#

proxyURL, err := url.Parse("http://USER:[email protected]:PORT")
if err != nil { log.Fatal(err) }
client := &http.Client{Transport: &http.Transport{
  Proxy: http.ProxyURL(proxyURL),
  TLSClientConfig: &tls.Config{InsecureSkipVerify: true}, // public-data-only isolated client
}}
response, err := client.Get("https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js")

Hai chặng TLS đã xác minh#

Chế độ bộ nhớ đệm kết thúc kết nối TLS phía client tại hub Litport đã chọn để có thể đọc một phản hồi đủ điều kiện và phục vụ bản sao cục bộ ở lần sau. Client xác minh chứng chỉ đích do hub cấp dựa trên chứng chỉ gốc bộ nhớ đệm của Litport. Riêng hub xác minh chứng chỉ và hostname thật của máy chủ gốc trước khi đọc phản hồi của máy chủ gốc. Hãy giữ xác minh bật ở cả hai ranh giới tin cậy.

Client của bạnTin cậy chứng chỉ gốc bộ nhớ đệm công khai của Litport
Chứng chỉ do Litport cấp cho đíchChặng TLS 1
Hub LitportCó thể đọc yêu cầu và phản hồi ở chế độ bộ nhớ đệm này
Chứng chỉ công khai và tên host đã được xác minhChặng TLS 2
Máy chủ gốc HTTPSĐến qua upstream đã chọn
Client xác minh chứng chỉ đích do Litport cấp ở chặng TLS 1. Hub xác minh riêng chứng chỉ công khai và hostname của máy chủ gốc ở chặng TLS 2.

Đích HTTP không có danh tính máy chủ gốc được xác thực và vẫn đi theo đường proxy thông thường. Hãy dùng đích HTTPS cho chế độ bộ nhớ đệm.

Danh tính chứng chỉ gốc đã công bố#

Tải xuống: https://litport.net/certificates/litport-cache-root.crt

Danh tính dạng máy đọc được (tùy chọn): litport-cache-root.json

Trường Giá trị
Subject O=Litport, CN=Litport cache root CA
Issuer O=Litport, CN=Litport cache root CA
Định dạng PEM Chứng chỉ X.509 mã hóa PEM
Có hiệu lực từ (UTC) 2026-09-08T18:54:30.000Z
Có hiệu lực đến (UTC) 2036-09-08T18:59:30.000Z
Vân tay SHA-256 X.509 6E:0D:49:97:67:B0:D5:E3:41:E3:C7:B8:CC:65:85:C2:FD:04:EE:64:E7:64:E8:5A:79:18:27:F6:DD:1E:FD:38
SHA-256 của tệp PEM đã tải xuống b5a687754f15ab2fe7a00fc77738bc8f9e608e890159e4eccf5cbd48a46a9b7a

Vân tay là giá trị băm của dạng DER của chứng chỉ. Giá trị kiểm tra của tệp là giá trị băm của các byte PEM đã tải xuống, gồm cả mã hóa văn bản và ký tự xuống dòng, nên hai giá trị SHA-256 này khác nhau.

curl --fail --remote-name https://litport.net/certificates/litport-cache-root.crt
openssl x509 -in litport-cache-root.crt -noout -subject -issuer -dates -fingerprint -sha256
sha256sum litport-cache-root.crt

Bản tải xuống chỉ chứa tài liệu chứng chỉ công khai, không bao giờ có khóa riêng. Một chứng chỉ gốc dùng được cho mọi hub đã chọn. Việc đổi hub có thể gây cache miss vì các mục nằm cục bộ trên hub; việc đó không yêu cầu chứng chỉ gốc mới.

Cài chứng chỉ gốc cho phép điều gì#

Chứng chỉ gốc công khai cho phép client của bạn xác thực các chứng chỉ đích do hệ thống CA bộ nhớ đệm của Litport cấp. Cùng chứng chỉ gốc đó cũng xác thực chứng chỉ mà hub trình ra ở endpoint proxy https:// của nó; xem Endpoint proxy HTTP và HTTPS. Litport giữ khóa riêng của chứng chỉ gốc ngoại tuyến; khóa này không được triển khai lên các hub. Mỗi hub nhận chứng chỉ trung gian và khóa riêng của chính nó, nên khóa gốc không bị lộ nếu một hub bị xâm phạm.

Với kết nối bật bộ nhớ đệm, hub đã chọn có thể đọc yêu cầu và phản hồi HTTPS. Cài chứng chỉ gốc cho toàn hệ thống cũng khiến mọi ứng dụng dùng kho đó chấp nhận các chứng chỉ do hệ thống bộ nhớ đệm của Litport cấp. Hãy giới hạn phạm vi tin cậy ở client bộ nhớ đệm hoặc container riêng của nó, chỉ dùng chế độ bộ nhớ đệm cho dữ liệu tĩnh công khai, và gỡ chứng chỉ gốc khi khối lượng công việc không còn cần đến. Nếu không có hậu tố _cache- hợp lệ, Litport giữ đường hầm HTTPS ở dạng không đọc được dù chứng chỉ gốc vẫn được cài.

Thiết lập client#

Ưu tiên tin cậy theo từng tiến trình, từng hồ sơ hoặc container riêng. Tin cậy cho toàn hệ thống có phạm vi rộng: mọi ứng dụng dùng kho đó đều có thể tin các chứng chỉ do chứng chỉ gốc này cấp. Thay USER, PASSWORD và PORT; mã hóa phần trăm các ký tự dành riêng của URL và không bao giờ commit bí mật proxy.

curl

curl --proxy 'http://hub-us-7.litport.net:PORT' \
  --proxy-user 'USER:PASSWORD_cache-scripts' \
  --cacert ./litport-cache-root.crt \
  'https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js'

Python

import requests

requests.get(
    "https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js",
    proxies={"https": "http://USER:[email protected]:PORT"},
    verify="litport-cache-root.crt",
    timeout=30,
)

Node

NODE_EXTRA_CA_CERTS=./litport-cache-root.crt node scraper.js

// Configure the Litport HTTP proxy in your Node client.
// Keep rejectUnauthorized at its default true.

Tự động hóa trình duyệt

// Trust litport-cache-root.crt in the isolated browser/profile
// trust store actually used by the automation browser.
// Keep ignoreHTTPSErrors: false.
// Do not use --ignore-certificate-errors.

Go

pool, _ := x509.SystemCertPool()
pem, _ := os.ReadFile("litport-cache-root.crt")
pool.AppendCertsFromPEM(pem)
transport := &http.Transport{
    Proxy: http.ProxyURL(proxyURL),
    TLSClientConfig: &tls.Config{RootCAs: pool, MinVersion: tls.VersionTLS12},
}

Java

keytool -importcert -alias litport-cache \
  -file litport-cache-root.crt \
  -keystore ./litport-cache-truststore.p12 \
  -storetype PKCS12

java -Djavax.net.ssl.trustStore=./litport-cache-truststore.p12 App

Android

<network-security-config>
  <base-config>
    <trust-anchors><certificates src="system" /></trust-anchors>
  </base-config>
  <debug-overrides>
    <trust-anchors>
      <certificates src="@raw/litport_cache_root" />
    </trust-anchors>
  </debug-overrides>
</network-security-config>

iPhone / iPad

1. Cài hồ sơ gốc Litport.
2. Mở Cài đặt → Cài đặt chung → Giới thiệu → Cài đặt tin cậy chứng nhận.
3. Bật tin cậy hoàn toàn cho chứng chỉ gốc Litport.
4. Gỡ hồ sơ khi thử nghiệm chế độ bộ nhớ đệm xong.

curl#

--cacert thay thế bộ CA mặc định của curl cho yêu cầu này. Hãy gộp các chứng chỉ gốc cần thiết vào một bộ CA riêng nếu đích cần thêm một CA riêng khác.

curl --proxy 'http://hub-us-7.litport.net:PORT' --proxy-user 'USER:PASSWORD_cache-scripts' \
  --cacert ./litport-cache-root.crt --verbose \
  'https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js'

Python Requests, httpx và aiohttp#

Tệp verify của Requests thay thế bộ CA mặc định của nó. Với httpx và aiohttp, hãy tạo ngữ cảnh mặc định trước, rồi gọi load_verify_locations() để thêm chứng chỉ gốc này vào các chứng chỉ gốc của hệ thống.

import asyncio, ssl
import aiohttp, httpx, requests
proxy = 'http://USER:[email protected]:PORT'
url = 'https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js'
requests.get(url, proxies={'https': proxy}, verify='litport-cache-root.crt', timeout=30)
context = ssl.create_default_context()
context.load_verify_locations(cafile='litport-cache-root.crt')
httpx.get(url, proxy=proxy, verify=context, timeout=30)
async def fetch():
    async with aiohttp.ClientSession(connector=aiohttp.TCPConnector(ssl=context)) as session:
        async with session.get(url, proxy=proxy) as response: return await response.read()
asyncio.run(fetch())

Client HTTPS của Node#

NODE_EXTRA_CA_CERTS thêm các chứng chỉ gốc vào Node. Một agent proxy HTTPS thực sự sẽ định tuyến lưu lượng; giữ rejectUnauthorized ở mặc định true.

npm install https-proxy-agent
NODE_EXTRA_CA_CERTS=./litport-cache-root.crt node scraper.mjs
import https from 'node:https'
import { HttpsProxyAgent } from 'https-proxy-agent'
const agent = new HttpsProxyAgent('http://USER:[email protected]:PORT')
https.get('https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js', { agent }, response => response.resume())

Thiết lập này không cấu hình lưu lượng của Chromium, Playwright hay Puppeteer.

Tự động hóa trình duyệt#

Hãy cài chứng chỉ gốc vào kho OS hoặc NSS của hồ sơ trình duyệt tách biệt. Giữ ignoreHTTPSErrors: false và không dùng --ignore-certificate-errors.

import { chromium } from 'playwright'
const browser = await chromium.launch({ proxy: {
  server: 'http://hub-us-7.litport.net:PORT', username: 'USER', password: 'PASSWORD_cache-scripts',
}})
const context = await browser.newContext({ ignoreHTTPSErrors: false })
await (await context.newPage()).goto('https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js')

Go#

pool, err := x509.SystemCertPool()
if err != nil || pool == nil { pool = x509.NewCertPool() }
pem, err := os.ReadFile("litport-cache-root.crt")
if err != nil || !pool.AppendCertsFromPEM(pem) { log.Fatal("could not add Litport root") }
proxyURL, err := url.Parse("http://USER:[email protected]:PORT")
if err != nil { log.Fatal(err) }
client := &http.Client{Transport: &http.Transport{
  Proxy: http.ProxyURL(proxyURL),
  TLSClientConfig: &tls.Config{RootCAs: pool, MinVersion: tls.VersionTLS12},
}}
response, err := client.Get("https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js")

SystemCertPool cùng AppendCertsFromPEM giữ nguyên các chứng chỉ gốc của hệ thống và thêm chứng chỉ gốc này vào.

Java#

Kho tin cậy riêng chỉ có phạm vi theo tiến trình, nhưng thay thế bộ CA mặc định của Java. Hãy nhập các chứng chỉ gốc cần thiết khác vào kho riêng đó.

keytool -importcert -noprompt -alias litport-cache -file litport-cache-root.crt \
  -keystore ./litport-cache-truststore.p12 -storetype PKCS12 -storepass changeit
java -Djavax.net.ssl.trustStore=./litport-cache-truststore.p12 \
  -Djavax.net.ssl.trustStoreType=PKCS12 -Djavax.net.ssl.trustStorePassword=changeit App

Cài và gỡ khỏi các kho tin cậy rộng#

Chỉ dùng cách này khi không thể tin cậy theo tiến trình/hồ sơ; chúng cũng ảnh hưởng đến các ứng dụng khác.

Debian và Ubuntu#

sudo install -m 0644 litport-cache-root.crt /usr/local/share/ca-certificates/litport-cache-root.crt
sudo update-ca-certificates
# Remove: sudo rm /usr/local/share/ca-certificates/litport-cache-root.crt && sudo update-ca-certificates

RHEL và Fedora#

sudo install -m 0644 litport-cache-root.crt /etc/pki/ca-trust/source/anchors/litport-cache-root.crt
sudo update-ca-trust extract
# Remove: sudo rm /etc/pki/ca-trust/source/anchors/litport-cache-root.crt && sudo update-ca-trust extract

macOS#

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain litport-cache-root.crt
# Remove: sudo security delete-certificate -c 'Litport cache root CA' /Library/Keychains/System.keychain

Windows#

Chạy trong PowerShell có quyền quản trị:

certutil -addstore -f Root .\litport-cache-root.crt
# Remove: certutil -delstore Root "Litport cache root CA"

Firefox và NSS#

Đặt FIREFOX_PROFILE thành thư mục hồ sơ chứa cert9.db; trên Debian/Ubuntu hãy cài libnss3-tools trước.

certutil -A -n 'Litport cache root' -t 'C,,' -i litport-cache-root.crt -d "sql:$FIREFOX_PROFILE"
# Remove: certutil -D -n 'Litport cache root' -d "sql:$FIREFOX_PROFILE"

Container và Kubernetes#

Hãy dùng image khối lượng công việc riêng hoặc mount runtime chỉ đọc thay vì tin cậy ở cấp máy chủ. Với Node:

COPY litport-cache-root.crt /opt/litport/litport-cache-root.crt
ENV NODE_EXTRA_CA_CERTS=/opt/litport/litport-cache-root.crt

Việc cập nhật kho hệ thống của bản phân phối sẽ khiến mọi tiến trình trong container tin cậy chứng chỉ. Với Kubernetes, hãy tạo một ConfigMap từ tệp PEM công khai đã tải xuống, rồi chỉ mount nó vào khối lượng công việc cần chế độ bộ nhớ đệm:

kubectl create configmap litport-cache-root --from-file=litport-cache-root.crt
# Pod template fragment
spec:
  containers:
    - name: client
      env:
        - name: NODE_EXTRA_CA_CERTS
          value: /var/run/litport-ca/litport-cache-root.crt
      volumeMounts:
        - { name: litport-cache-root, mountPath: /var/run/litport-ca, readOnly: true }
  volumes:
    - name: litport-cache-root
      configMap: { name: litport-cache-root }

Android#

Các ứng dụng Android 7.0+ thường không tin cậy CA do người dùng thêm. CA được đóng gói kèm là phạm vi hẹp: hãy đưa tệp PEM này vào bản debug và chỉ tin cậy nó. src="user" tin cậy mọi CA do người dùng cài và rộng hơn mức hầu hết ứng dụng production nên chấp nhận. Android mô tả các nguồn tin cậy và phần ghi đè cho debug này ở Network Security Configuration.

<!-- AndroidManifest.xml -->
<application android:networkSecurityConfig="@xml/network_security_config" />

Bản release giữ nguyên các chứng chỉ gốc hệ thống thông thường:

<!-- src/main/res/xml/network_security_config.xml -->
<network-security-config><base-config><trust-anchors><certificates src="system" /></trust-anchors></base-config></network-security-config>

Bản debug thêm chứng chỉ gốc Litport được đóng gói kèm:

<!-- src/debug/res/xml/network_security_config.xml -->
<network-security-config>
  <base-config><trust-anchors><certificates src="system" /></trust-anchors></base-config>
  <debug-overrides><trust-anchors><certificates src="@raw/litport_cache_root" /></trust-anchors></debug-overrides>
</network-security-config>

Đặt tệp PEM tại src/debug/res/raw/litport_cache_root.pem. Ứng dụng của bên thứ ba có chính sách tin cậy không thể thay đổi sẽ không tương thích với chế độ bộ nhớ đệm đã xác minh; hãy gỡ hậu tố _cache-.

iPhone và iPad#

Cài hồ sơ chứng chỉ gốc đã tải xuống, rồi hoàn tất cài đặt trong Cài đặt → Cài đặt chung → VPN và quản lý thiết bị. Trong Cài đặt → Cài đặt chung → Giới thiệu → Cài đặt tin cậy chứng nhận, hãy bật tin cậy hoàn toàn cho chứng chỉ gốc Litport. Gỡ nó qua VPN và quản lý thiết bị → hồ sơ → Gỡ hồ sơ. Các thiết bị được quản lý nên cài và gỡ cùng payload đó qua MDM. Ứng dụng có chính sách riêng hoặc ghim chứng chỉ vẫn có thể từ chối kết nối. Apple mô tả bước tin cậy hoàn toàn riêng biệt này ở Trust manually installed certificate profiles.

Xác minh cấu hình#

  1. Gửi một yêu cầu đối chứng không có hậu tố: nó không cần chứng chỉ gốc và dùng hành vi proxy thông thường.
  2. Gửi cùng yêu cầu HTTPS đó với mật khẩu bật bộ nhớ đệm hợp lệ và xác minh được bật.
  3. Lặp lại đúng yêu cầu đó tới cùng hub. Xem thống kê bộ nhớ đệm để thấy một lượt miss rồi một lượt hit; đừng giả định có header bộ nhớ đệm riêng.
  4. Thêm --verbose vào yêu cầu curl đã xác minh và xác nhận việc xác minh chứng chỉ thành công và bên cấp hiển thị thuộc hệ thống bộ nhớ đệm của Litport.
  5. Đổi hub có thể gây cache miss vì các mục nằm cục bộ trên hub; việc đó không yêu cầu chứng chỉ gốc mới.
curl --proxy 'http://hub-us-7.litport.net:PORT' --proxy-user 'USER:PASSWORD_cache-scripts' \
  --cacert ./litport-cache-root.crt --verbose --output /dev/null \
  'https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js'

Các triệu chứng riêng về chứng chỉ#

Triệu chứng Nguyên nhân Cách khắc phục
unknown authority, unable to get local issuer hoặc CERTIFICATE_VERIFY_FAILED Bên gọi không tin cậy chứng chỉ gốc. Thêm nó vào tiến trình, hồ sơ, container hoặc kho đó; giữ xác minh luôn bật.
curl chạy được, ứng dụng lỗi Cài đặt CA của curl chỉ có phạm vi trong curl. Cấu hình bộ CA tin cậy riêng của ứng dụng, giữ các chứng chỉ gốc cần thiết.
Lỗi trên trình duyệt Trình duyệt/hồ sơ dùng kho khác. Cài vào kho OS/NSS thực tế của nó; giữ xác minh của trình duyệt.
Ứng dụng ghim chứng chỉ bị lỗi Việc ghim từ chối chứng chỉ đích được cấp. Chỉ chủ sở hữu mới đổi được phần ghim; dùng chế độ thông thường.
Đích HTTP Không có chặng TLS tới máy chủ gốc được xác thực. Dùng đích HTTPS, không chỉ một endpoint proxy HTTP.

Thay chứng chỉ gốc và an toàn thông tin đăng nhập#

Trong lúc thay chứng chỉ gốc, hãy xác minh vân tay đã công bố và giá trị kiểm tra tệp của PEM mới, tin cậy cả hai chứng chỉ gốc trong thời gian chồng lấn đã nêu, kiểm thử chế độ bộ nhớ đệm, rồi gỡ chứng chỉ gốc cũ khỏi mọi bộ CA riêng, hồ sơ trình duyệt, image và payload thiết bị được quản lý sau thời gian chồng lấn. Dùng URL proxy đặt trong dấu nháy và --proxy-user khi có thể; dùng kho bí mật hoặc biến môi trường được đưa vào, mã hóa phần trăm các ký tự URL dành riêng, và không bao giờ commit bí mật proxy hay lịch sử lệnh có chứa mật khẩu.

Quay lại bắt đầu nhanh về bộ nhớ đệm hoặc tùy chọn và khắc phục sự cố.