Начало работы

Это руководство поможет вам подключиться к Privacy Proxy и убедиться, что трафик проксируется корректно.

Перед началом работы

Privacy Proxy представляет собой управляемый сервис. Прежде чем вы сможете подключиться, Cloudflare выделит конечную точку и предоставит вам следующее:

URL-адрес конечной точки прокси: хост для вашего экземпляра Privacy Proxy (например, https://your-proxy.example.com).
Pre-shared key (PSK): секретный ключ для аутентификации в целях демонстрации концепции.
Диапазоны исходящих IP-адресов: IP-адреса, которые серверы назначения будут видеть для проксированного трафика.

Свяжитесь с нами ↗ чтобы запросить доступ и получить данные для настройки.

1. Настройте клиент

Privacy Proxy принимает соединения по HTTP/2 и HTTP/3 с использованием метода HTTP CONNECT. Поскольку для работы Privacy Proxy требуются заголовки аутентификации, настроить браузеры для прямого подключения нельзя. Вместо этого используйте один из следующих подходов:

Используйте curl для локального тестирования

Для быстрых проверок используйте curl с --proxy и --proxy-header флаги для прямой передачи данных аутентификации:

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

Используйте Chaussette

Chaussette это локальный прокси SOCKS5, который выполняет аутентификацию и перенаправляет запросы в Privacy Proxy.

Запустите Chaussette, указав свой PSK и конечную точку прокси:

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

Настройте браузер на использование локального прокси SOCKS5:
```
google-chrome --proxy-server="socks5://127.0.0.1:1987"
```

2. Проверьте соединение

Чтобы убедиться, что трафик проходит через Privacy Proxy, проверьте свой видимый IP-адрес:

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

Ответ включает метаданные соединения. Обратите внимание на поле ip поле, в котором должен отображаться исходящий IP-адрес Cloudflare, а не ваш реальный IP-адрес.

Пример ответа

fl=123f456
h=cloudflare.com
ip=162.159.xxx.xxx
ts=1234567890.123
visit_scheme=https
uag=curl/8.0.0
colo=SJC
http=http/2
loc=US
tls=TLSv1.3

ip значение подтверждает исходящий IP-адрес, который использовал прокси.

3. (Необязательно) Проверьте геолокацию

Privacy Proxy сохраняет геолокацию пользователя, выбирая исходящие IP-адреса на основе местоположения клиента. Чтобы проверить это поведение, можно указать geohash:

curl -v \
  --proxy https://your-proxy.example.com \
  --proxy-header "Proxy-Authorization: Preshared <YOUR_PSK>" \
  --proxy-header "sec-ch-geohash: xn76c-JP" \
  https://cloudflare.com/cdn-cgi/trace

sec-ch-geohash заголовок предоставляет geohash ↗ который прокси использует для выбора подходящего исходящего IP-адреса. Формат: <geohash>-<country_code>.

В ответе должен отображаться loc значение, соответствующее региону geohash.

Следующие шаги

Подробнее о модели развертывания чтобы разобраться в архитектурах с одним переходом и с двумя переходами.
Проверьте методы аутентификации для промышленных развёртываний, использующих Privacy Pass.
Настройте наблюдаемость для мониторинга трафика прокси с помощью GraphQL Analytics и OpenTelemetry.