← Privacy Proxy / privacy-proxy / reference

Клиентские библиотеки

На этой странице перечислены библиотеки и инструменты с открытым исходным кодом, которые можно использовать для подключения к Privacy Proxy.

tokio-quiche ↗ является открытой асинхронной библиотекой QUIC и HTTP/3 от Cloudflare для Rust. Она сочетает quiche ↗ реализацию QUIC с Tokio ↗ асинхронной средой выполнения.

На tokio-quiche работает инфраструктура Privacy Proxy, включая Proxy B для iCloud Private Relay и прокси Cloudflare на базе Oxy. В производственной среде он обрабатывает миллионы запросов HTTP/3 в секунду.

• Асинхронные клиент и сервер QUIC
• Поддержка HTTP/3 через H3Driver
• Поддержка MASQUE CONNECT и CONNECT-UDP
• Проверено в реальных условиях в масштабе сети Cloudflare

Добавьте tokio-quiche в ваш Cargo.toml:

[dependencies]
tokio-quiche = "0.1"

• репозиторий GitHub ↗
• crates.io ↗
• Запись в блоге: Async QUIC and HTTP/3 made easy ↗

quiche ↗ является низкоуровневой реализацией QUIC и HTTP/3 от Cloudflare на языке Rust. Она построена по принципу sans-io и может быть встроена в архитектуру любого приложения.

quiche является основой, на которой построен tokio-quiche. Используйте quiche напрямую, если вам нужен точный контроль над вводом-выводом или вы интегрируетесь со средой выполнения, отличной от Tokio.

• репозиторий GitHub ↗
• Документация ↗
• crates.io ↗

Chaussette ↗ это прокси SOCKS5-to-CONNECT, разработанный для Privacy Proxy. Он принимает локальные соединения SOCKS5 и перенаправляет их в Privacy Proxy в виде запросов HTTP CONNECT.

Chaussette удобен для интеграции приложений, которые поддерживают SOCKS5, но не поддерживают проксирование через HTTP CONNECT.

• Преобразование SOCKS5 в HTTP CONNECT
• Аутентификация с предварительно распределенным ключом
• Поддержка geohash для подсказок геолокации
• Необязательная аутентификация mTLS

MASQUE_PRESHARED_KEY=<YOUR_PSK> chaussette \
  --listen 127.0.0.1:1987 \
  --proxy https://your-proxy.example.com:443 \
  --geohash xn76c-JP

Затем настройте приложение на использование socks5://127.0.0.1:1987 в качестве своего прокси.

• репозиторий GitHub ↗

Для базового тестирования по HTTP/2 обычный curl поддерживает проксирование через CONNECT:

curl -v \
  --proxy https://your-proxy.example.com \
  --proxy-header "Proxy-Authorization: Preshared <YOUR_PSK>" \
  https://example.com

curl также можно собрать с использованием quiche ↗ для поддержки HTTP/3.

privacypass-ts ↗ является реализацией протокола Privacy Pass от Cloudflare на TypeScript. Используйте эту библиотеку для выпуска и погашения токенов Privacy Pass при аутентификации в Privacy Proxy.

• Выпуск и предъявление токенов Privacy Pass
• Поддержка публично проверяемых и ограниченных по частоте типов токенов
• Совместимо со средами браузера и Node.js

npm install @cloudflare/privacypass-ts

• репозиторий GitHub ↗
• пакет npm ↗