Endpoint proxy HTTPS
Mọi endpoint proxy HTTP của Litport cũng chấp nhận TLS trên cùng host và cổng. Đổi lược đồ trong
URL proxy từ http:// sang https:// và kết nối giữa client và hub sẽ được mã hóa. Thông tin đăng nhập, cổng và đích đều giữ nguyên. Phần dữ liệu TLS phát sinh được tính là lưu lượng (xem
chi phí), và một lần bắt tay thất bại sẽ đóng kết nối mà không có
X-Proxy-Error-Code để kiểm tra (xem kiểm tra TLS có thực sự được dùng).
| Lược đồ | Từ client đến hub | Ví dụ |
|---|---|---|
http:// |
Không mã hóa | http:// |
https:// |
TLS | https:// |
PORT là cổng proxy HTTP hiển thị cho token của bạn trong bảng điều khiển (1337 và 31337 là các giá trị
mặc định; xem Đầu vào proxy). Endpoint SOCKS5 không có
biến thể TLS.
Chọn mức bảo mật#
Có ba cách để giao tiếp với proxy. Hãy chọn cách phù hợp với nơi client của bạn chạy; phần còn lại của trang này hướng dẫn thiết lập từng cách.
| Mức | URL proxy và thiết lập | Bên quan sát thụ động (Wi-Fi, ISP, mạng dùng chung) | Kẻ tấn công chủ động (chuyển hướng kết nối của bạn) | Hỗ trợ client |
|---|---|---|---|---|
| 0. Không mã hóa | http://, không cần gì thêm |
Đọc được thông tin đăng nhập, mọi hostname trong CONNECT và nội dung HTTP thuần |
Như nhau | Mọi client |
| 1. Mã hóa, không xác minh | https:// cùng tùy chọn “bỏ qua xác minh proxy” của client |
Không thấy gì | Có thể giả mạo hub và lấy thông tin đăng nhập của bạn | Hầu hết thư viện; không áp dụng cho trình duyệt, và không áp dụng cho Requests nếu không bỏ cả xác minh đích |
| 2. Mã hóa và có xác minh (Khuyến nghị) | https:// cùng tệp chứng chỉ gốc Litport |
Không thấy gì | Thất bại an toàn: client từ chối mọi thứ không phải hub Litport | Mọi client hỗ trợ proxy https:// |
Khuyến nghị: dùng mức 2. Chỉ cần một tệp công khai và một tùy chọn, và đây là mức duy nhất bảo vệ được thông tin đăng nhập có thể dùng để tiêu tiền trước cả hai loại kẻ tấn công. Hãy tải chứng chỉ gốc một lần và giữ nó cạnh mã của bạn:
curl --fail --remote-name https://litport.net/certificates/litport-cache-root.crt
Mức 1 là một bước nâng cấp hợp lý so với dạng không mã hóa cho một lần thử thủ công nhanh hoặc một client mà bạn không thể đưa tệp vào. Mức 0 là mặc định chỉ vì mọi client đều hỗ trợ; hãy bỏ mức này ở bất cứ nơi nào mà mạng giữa bạn và hub không phải của bạn.
Hai thứ khác nhau cùng gọi là “proxy HTTPS”#
- Proxy một đích HTTPS là việc proxy HTTP vẫn luôn làm: client gửi
CONNECT example.com:443, hub mở một đường hầm, và phiên TLS của bạn chạy đầu cuối bên trong đó. Endpoint proxyhttp://hỗ trợ việc này; nội dung đường hầm không đọc được với Litport trừ khi bạn chọn dùng chế độ bộ nhớ đệm. - Endpoint proxy HTTPS mã hóa chặng giữa client và chính hub. Mọi thứ
bạn gửi tới proxy, gồm cả dòng
CONNECTvà thông tin đăng nhập, đi bên trong phiên TLS đó.
Trang này nói về loại thứ hai. Hai loại độc lập với nhau: bạn có thể dùng bất kỳ lược đồ nào cho mọi đích.
Endpoint không mã hóa làm lộ gì (mức 0)#
Với http://, mọi thứ trên đường giữa client và hub đều có thể đọc:
| Bị lộ trên đường truyền | Hậu quả |
|---|---|
Header Proxy-Authorization |
Tên người dùng và mật khẩu proxy của bạn, ở mỗi yêu cầu. Ai lấy được thông tin đăng nhập trả theo GB đều có thể tiêu tiền bằng nó. |
Dòng CONNECT host:port |
Mọi hostname bạn kết nối tới, ngay cả khi bản thân đường hầm đã được mã hóa. |
Yêu cầu tới đích http:// thuần |
Toàn bộ nội dung yêu cầu và phản hồi. |
“Trên đường” gồm mạng cục bộ bạn đang dùng, ISP của bạn, mạng đám mây dùng chung, proxy egress của doanh nghiệp và mọi chặng có ghi log lưu lượng. Trang đích thấy giống nhau trong cả hai trường hợp: IP đầu ra đã chọn, không bao giờ là IP của bạn.
Khi nào dùng https://#
Dùng endpoint HTTPS khi:
- Client ở trên mạng bạn không kiểm soát. Laptop dùng Wi-Fi công cộng, văn phòng dùng chung, mạng khách sạn và sân bay, và mọi môi trường có thiết bị kiểm tra trong suốt.
- Client chạy trên hạ tầng dùng chung hoặc của bên thứ ba. Runner CI, hàm serverless, VPC đám mây dùng chung và container trên máy chủ bạn không quản trị. Việc lấy thông tin đăng nhập ở đó diễn ra âm thầm và kéo dài.
- Bản thân danh sách đích là thông tin nhạy cảm. Các dòng
CONNECTcho biết bạn nghiên cứu những host nào, ngay cả khi nội dung được mã hóa. - Bạn gửi tới các đích
http://thuần. Nội dung đó nếu không sẽ bị đọc được đầu cuối ở chặng đầu tiên. - Lưu lượng proxy thuần bị chặn hoặc bị giới hạn. Một số mạng đánh dấu
CONNECTtrên cổng không chuẩn; TLS tới một hostname trông như HTTPS thông thường.
Giữ http:// khi:
- Client và hub đã có sẵn một đường riêng, được mã hóa, ví dụ VPN vào một mạng bạn kiểm soát, và bạn muốn chi phí phát sinh cho mỗi kết nối là nhỏ nhất.
- Thư viện client hoàn toàn không thể thương lượng TLS tới proxy (xem ghi chú về client bên dưới).
- Bạn mở rất nhiều kết nối ngắn và lần bắt tay thêm ở mỗi kết nối quan trọng hơn nguy cơ bị lộ.
Chi phí#
- Thêm một lần TLS handshake cho mỗi kết nối. Client giữ kết nối (keep-alive) chỉ trả một lần cho mỗi kết nối, không phải mỗi yêu cầu.
- Phần dữ liệu TLS phát sinh được tính là lưu lượng. Việc đóng khung bản ghi và quá trình bắt tay là các byte đi qua hub, nên các yêu cầu thông thường (không dùng bộ nhớ đệm) bị tính cao hơn một chút, thường là vài phần trăm với yêu cầu nhỏ và không đáng kể với truyền tải lớn. Cách tính ở chế độ bộ nhớ đệm không đổi.
- Client của bạn phải tin cậy chứng chỉ gốc Litport cho kết nối proxy. Đó là nội dung của
phần tiếp theo, và là lý do
curl -kkhông giúp được.
Chứng chỉ hub và lý do -k không hoạt động#
Mức 2 nghĩa là xác minh chứng chỉ của hub. Hub trình ra chứng chỉ cho hostname của chính nó (ví dụ hub-eu-1.litport.net) do
chứng chỉ gốc bộ nhớ đệm của Litport cấp. Chứng chỉ gốc đó không nằm trong kho tin cậy của
hệ điều hành, nên client xác minh chứng chỉ proxy theo bộ CA mặc định sẽ thất bại:
curl: (60) SSL certificate problem: unable to get local issuer certificate
curl -k không sửa được lỗi này. Client giữ hai chặng TLS riêng biệt với các thiết lập riêng:
| Chặng TLS | Bảo vệ gì | Tùy chọn curl |
|---|---|---|
| Client tới proxy | Thông tin đăng nhập và các dòng CONNECT của bạn |
--proxy-cacert, --proxy-insecure |
| Client tới đích (bên trong đường hầm) | Trang bạn đang lấy dữ liệu | --cacert, -k / --insecure |
-k chỉ nới lỏng chặng tới đích. Chặng tới proxy vẫn xác minh theo bộ CA của hệ thống và bị hủy.
Hãy trỏ chặng proxy tới chứng chỉ gốc Litport thay vào đó:
curl --fail --remote-name https://litport.net/certificates/litport-cache-root.crt
curl --proxy-cacert litport-cache-root.crt \
-x 'https://USER:[email protected]:PORT' \
'https://example.com/'
Hai điều cần biết trước khi bạn cài chứng chỉ gốc đó rộng hơn:
- Tin cậy chứng chỉ gốc cho chặng proxy không bật chế độ bộ nhớ đệm. Chế độ bộ nhớ đệm cần hậu tố mật khẩu
_cache-trên thông tin đăng nhập; nếu không có, đường hầm vẫn không đọc được. - Cùng chứng chỉ gốc đó cũng có thể cấp chứng chỉ cho việc đánh chặn ở chế độ bộ nhớ đệm. Nếu bạn không muốn thêm nó vào kho toàn hệ thống, hãy giới hạn nó trong tiến trình hoặc container dùng proxy, như mọi ví dụ bên dưới.
Luôn dùng hostname của hub, không bao giờ dùng địa chỉ IP của nó. Chứng chỉ được cấp cho hostname.
Mức 2: ví dụ client có xác minh#
Thay USER, PASSWORD và PORT; mã hóa phần trăm các ký tự dành riêng trong thông tin đăng nhập. Tất cả
ví dụ xác minh chứng chỉ proxy theo litport-cache-root.crt và giữ xác minh thông thường bằng CA công khai cho đích. Mỗi phần kết thúc bằng cách chuyển sang mức 1 để bỏ qua xác minh
chỉ ở chặng proxy; hãy đọc Mức 1 để biết cái giá phải trả
trước khi dùng.
curl#
Có xác minh (khuyến nghị):
curl --proxy-cacert litport-cache-root.crt \
-x 'https://hub-eu-1.litport.net:PORT' --proxy-user 'USER:PASSWORD' \
'https://example.com/'
Thêm --verbose để thấy hai lần bắt tay: lần đầu với proxy (hub-eu-1.litport.net), rồi
CONNECT bên trong nó, rồi lần bắt tay với đích.
Không xác minh, chỉ để thử tạm (thông tin đăng nhập vẫn được mã hóa, nhưng client không thể phân biệt hub thật với kẻ giả mạo):
curl --proxy-insecure -x 'https://USER:[email protected]:PORT' 'https://example.com/'
--proxy-cacert cần curl 7.52 trở lên, phiên bản mà mọi bản phân phối hiện nay đều có.
Python Requests#
Requests dùng một bộ CA cho cả hai chặng, và verify= thay thế bộ CA mặc định của nó. Hãy tạo một
bộ CA gộp một lần để đích giữ được xác minh bằng CA công khai:
cat "$(python -c 'import certifi; print(certifi.where())')" litport-cache-root.crt > litport-bundle.pem
import requests
proxy = 'https://USER:[email protected]:PORT'
response = requests.get(
'https://example.com/',
proxies={'http': proxy, 'https': proxy},
verify='litport-bundle.pem',
timeout=30,
)
Hãy liệt kê proxy ở cả hai khóa http và https; Requests chọn mục theo lược đồ của đích.
TLS-trong-TLS qua proxy https:// cần urllib3 1.26 trở lên, mà Requests 2.26 trở lên
phụ thuộc vào.
Requests không có công tắc chỉ cho proxy: verify=False tắt xác minh ở cả hai chặng, hub
và đích, và in cảnh báo ở mỗi yêu cầu. Chỉ dùng cho các lần thử tạm.
response = requests.get('https://example.com/', proxies={'http': proxy, 'https': proxy}, verify=False, timeout=30)
Python httpx#
httpx tách thiết lập TLS của proxy khỏi thiết lập của đích:
import ssl
import httpx
context = ssl.create_default_context()
context.load_verify_locations(cafile='litport-cache-root.crt')
proxy = httpx.Proxy('https://USER:[email protected]:PORT', ssl_context=context)
with httpx.Client(proxy=proxy, timeout=30) as client:
response = client.get('https://example.com/')
ssl_context trên Proxy chỉ xác minh hub; ngữ cảnh mặc định của client vẫn xác minh
đích. Để bỏ qua chặng proxy nhưng vẫn xác minh đích, hãy đưa cho Proxy một ngữ cảnh đã
tắt xác minh:
insecure = ssl.create_default_context()
insecure.check_hostname = False
insecure.verify_mode = ssl.CERT_NONE
proxy = httpx.Proxy('https://USER:[email protected]:PORT', ssl_context=insecure)
Node#
https-proxy-agent chấp nhận URL proxy https:// và xác minh hub bằng kho tin cậy của Node, nên
hãy thêm chứng chỉ gốc qua NODE_EXTRA_CA_CERTS. Nó không tắt xác minh ở bất kỳ đâu.
npm install https-proxy-agent
NODE_EXTRA_CA_CERTS=./litport-cache-root.crt node fetch.mjs
import https from 'node:https'
import { HttpsProxyAgent } from 'https-proxy-agent'
const agent = new HttpsProxyAgent('https://USER:[email protected]:PORT')
https.get('https://example.com/', { agent }, response => response.resume())
Với undici (cũng là engine phía sau fetch toàn cục trong Node 18 trở lên), chặng proxy có
các tùy chọn TLS riêng, nên không cần biến môi trường:
import { readFileSync } from 'node:fs'
import { ProxyAgent, fetch } from 'undici'
const dispatcher = new ProxyAgent({
uri: 'https://hub-eu-1.litport.net:PORT',
token: 'Basic ' + Buffer.from('USER:PASSWORD').toString('base64'),
proxyTls: { ca: [readFileSync('litport-cache-root.crt')] },
})
const response = await fetch('https://example.com/', { dispatcher })
Cả hai thư viện đều có thể chỉ bỏ qua chặng proxy. Với https-proxy-agent, đối số thứ hai được truyền
cho kết nối TLS tới hub; với undici đó là proxyTls. Xác minh đích vẫn bật. Đừng
dùng NODE_TLS_REJECT_UNAUTHORIZED=0, vì nó tắt xác minh ở mọi nơi trong tiến trình.
const agent = new HttpsProxyAgent('https://USER:[email protected]:PORT', { rejectUnauthorized: false })
const dispatcher = new ProxyAgent({ uri: 'https://hub-eu-1.litport.net:PORT', token, proxyTls: { rejectUnauthorized: false } })
Go#
http.Transport của Go kết nối tới proxy https:// bằng cùng TLSClientConfig mà nó dùng cho
các đích, nên hãy thêm chứng chỉ gốc vào pool hệ thống thay vì thay thế nó:
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("https://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://example.com/")
Go áp dụng TLSClientConfig cho cả hai chặng, nên InsecureSkipVerify: true cũng sẽ ngừng xác minh
đích. Không có công tắc chỉ cho proxy; hãy giữ chứng chỉ gốc trong pool thay vào đó.
PHP#
Extension curl cung cấp các tùy chọn cho chặng proxy giống như dòng lệnh:
$ch = curl_init('https://example.com/');
curl_setopt_array($ch, [
CURLOPT_PROXY => 'https://hub-eu-1.litport.net:PORT',
CURLOPT_PROXYUSERPWD => 'USER:PASSWORD',
CURLOPT_PROXY_CAINFO => __DIR__ . '/litport-cache-root.crt',
CURLOPT_RETURNTRANSFER => true,
]);
$body = curl_exec($ch);
Để chỉ bỏ qua chặng proxy, hãy thay CURLOPT_PROXY_CAINFO bằng
CURLOPT_PROXY_SSL_VERIFYPEER => false và CURLOPT_PROXY_SSL_VERIFYHOST => 0; CURLOPT_SSL_VERIFYPEER
của đích giữ nguyên mặc định.
Java#
java.net.http.HttpClient có sẵn của JDK chỉ hỗ trợ proxy không mã hóa. Hãy dùng Apache HttpClient
5, thư viện chấp nhận host proxy https, và cung cấp cho JVM một kho tin cậy chứa chứng chỉ gốc Litport
cùng với các chứng chỉ gốc mặc định:
keytool -importcert -noprompt -alias litport-cache -file litport-cache-root.crt \
-keystore ./litport-truststore.p12 -storetype PKCS12 -storepass changeit
java -Djavax.net.ssl.trustStore=./litport-truststore.p12 \
-Djavax.net.ssl.trustStoreType=PKCS12 -Djavax.net.ssl.trustStorePassword=changeit App
HttpHost proxy = new HttpHost("https", "hub-eu-1.litport.net", PORT);
BasicCredentialsProvider credentials = new BasicCredentialsProvider();
credentials.setCredentials(new AuthScope(proxy), new UsernamePasswordCredentials("USER", "PASSWORD".toCharArray()));
try (CloseableHttpClient client = HttpClients.custom()
.setProxy(proxy)
.setDefaultCredentialsProvider(credentials)
.build()) {
client.execute(new HttpGet("https://example.com/"), response -> EntityUtils.toString(response.getEntity()));
}
Kho tin cậy riêng thay thế bộ CA mặc định của JVM, nên hãy nhập thêm các chứng chỉ gốc công khai bạn cần vào đó,
hoặc nhập chứng chỉ gốc Litport vào một bản sao cacerts của JVM. Java không có công tắc
chỉ cho proxy: một TrustManager tin tất cả cũng sẽ ngừng xác minh các đích, nên hãy dùng kho tin cậy.
Trình duyệt và tự động hóa trình duyệt#
Trình duyệt xác minh chứng chỉ proxy bằng kho của hệ điều hành (Firefox dùng kho riêng của nó). Hãy cài chứng chỉ gốc vào đó cho hồ sơ bạn dùng, rồi trỏ trình duyệt tới proxy HTTPS:
- Chrome và Edge: khởi động với
--proxy-server="https://hub-eu-1.litport.net:PORT", hoặc dùng một tệp PAC trả vềHTTPS hub-eu-1.litport.net:PORT. Trình duyệt sẽ hỏi thông tin đăng nhập proxy. - Firefox: dùng tệp PAC với cùng chỉ thị
HTTPS host:port, hoặc đặt loại proxy thành HTTPS trong cài đặt kết nối. - Playwright và Puppeteer: truyền
server: 'https://hub-eu-1.litport.net:PORT'cùng tên người dùng và mật khẩu. Trình duyệt vẫn cần chứng chỉ gốc trong kho của nó;ignoreHTTPSErrorsvà--ignore-certificate-errorschỉ ảnh hưởng đến chứng chỉ của đích. Trình duyệt không bao giờ bỏ qua xác minh chứng chỉ proxy, nên cài chứng chỉ gốc là lựa chọn duy nhất.
Hướng dẫn cho từng kho của hệ điều hành và Firefox có ở trang chứng chỉ.
Client không hỗ trợ TLS tới proxy#
Trình tải xuống mặc định của Scrapy, HttpClient của JDK và nhiều thư viện HTTP cũ chỉ có thể nói chuyện với
proxy không mã hóa. Với chúng, hãy giữ http:// hoặc chạy một bộ chuyển tiếp cục bộ nhỏ trên 127.0.0.1 để
nhận kết nối không mã hóa và kết nối tới hub qua TLS; chặng nhạy cảm khi đó nằm ngay trên máy của bạn.
Mức 1: mã hóa nhưng không xác minh#
Mọi ví dụ có xác minh ở trên đều có biến thể không xác minh. Bỏ qua xác minh vẫn giữ chặng được
mã hóa, nên bên quan sát thụ động trên mạng vẫn không thấy gì. Nó mất đi sự đảm bảo rằng
bạn đang nói chuyện với một hub Litport: kẻ tấn công chủ động nào chuyển hướng được kết nối của bạn đều có thể trình ra
bất kỳ chứng chỉ nào và lấy thông tin đăng nhập của bạn. Đó cũng là mức lộ của mức 0 trước
kẻ tấn công chủ động, vì vậy hãy xem mức 1 là bước nâng cấp so với http://, không tương đương mức 2.
| Client | Chỉ chặng proxy | Cả hai chặng |
|---|---|---|
| curl | --proxy-insecure |
--proxy-insecure -k |
| Python Requests | không có | verify=False |
| Python httpx | Proxy(..., ssl |
thêm verify=False trên client |
Node https-proxy-agent |
tùy chọn agent { reject |
NODE (nên tránh) |
| Node undici | proxyTls: { reject |
thêm requestTls: { reject |
| Go | không có | Insecure |
| PHP curl | CURLOPT / CURLOPT |
thêm CURLOPT |
| Java | không có | TrustManager tin tất cả (nên tránh) |
| Trình duyệt | không có | không có; hãy cài chứng chỉ gốc |
Hãy ưu tiên mức 2 cho mọi thứ chạy không cần người giám sát. Xác minh chỉ tốn một tệp và một tùy chọn; thông tin đăng nhập mà nó bảo vệ có thể dùng để tiêu tiền.
Kiểm tra TLS có thực sự được dùng#
curl --verbosein quá trình bắt tay với proxy trước dòngCONNECT, gồm cả subject chứng chỉCN=hub-eu-1.litport.net.- Mật khẩu sai qua
https://vẫn trả về407kèmX-Proxy-Error-Code: 4, giống hệt như quahttp://; các header lỗi đi bên trong TLS. - Nếu kết nối đóng ngay mà không có phản hồi HTTP nào, nghĩa là hub không thể hoàn tất
TLS handshake. Hãy kiểm tra bạn đã dùng hostname thay vì địa chỉ IP, lược đồ là
https://trên cổng HTTP chứ không phải cổng SOCKS5, và client của bạn tin cậy chứng chỉ gốc Litport cho chặng proxy. Xem Tài liệu tham chiếu lỗi proxy.
Trang liên quan#
- Token, sản phẩm proxy và hub về cổng và thông tin đăng nhập.
- Thiết lập chứng chỉ bộ nhớ đệm về danh tính, vân tay của chứng chỉ gốc và cách cài theo từng kho.
- Bộ nhớ đệm phản hồi tĩnh nếu bạn cũng muốn các phản hồi tĩnh lặp lại được phục vụ miễn phí.