BlankTrail Proxy
Войти Начать работу

Подключение приложений

После того как порт открыт, направьте на него любой инструмент, поддерживающий работу через прокси. На этой странице показан формат адреса прокси и готовые примеры для браузеров, curl и кода.

Адрес прокси

Каждый открытый порт — это стандартный прокси на вашем локальном компьютере. Используйте хост, на котором запущен BlankTrail Proxy (127.0.0.1 для локальной установки), и номер порта из дашборда. Порт работает по протоколу SOCKS5 или HTTP — в зависимости от того, что вы выбрали при его открытии.

socks5://127.0.0.1:20134
http://127.0.0.1:20250
СоветНа вкладке «Обзор» у каждого порта есть кнопка копирования в один клик, которая копирует полный адрес прокси.

Приложению, которое не умеет прокси вовсе, порт указать негде. Для такого случая есть перехват: трафик выбранных программ уводится на порт средствами системы, и профиль применяется к ним так же — см. Дашборд → Перехват системного трафика.

Доверие сертификату

Чтобы HTTPS работал без ошибок, устройство или инструмент должны доверять корневому сертификату (CA) BlankTrail Proxy (см. Установка → Корневой сертификат). Некоторые HTTP-клиенты позволяют указать путь к файлу сертификата напрямую, не устанавливая его в масштабах всей системы.

Браузеры и антидетект-браузеры

Укажите порт в качестве HTTP/SOCKS-прокси браузера (либо, в антидетект-браузере, в качестве вышестоящего прокси для профиля). Для управления настоящим браузером открывайте порт с пресетом «Браузер», чтобы его отпечаток был сопоставлен и нормализован.

Он работает как локальный прокси без дополнительной настройки для ZennoPoster, BAS, Puppeteer, Playwright, Selenium и любого инструмента, поддерживающего HTTP/HTTPS- или SOCKS5-прокси, — без изменений в ваших скриптах.

curl

curl -x socks5://127.0.0.1:20134 https://example.com
curl -x http://127.0.0.1:20250 https://example.com

Примеры кода

Python (requests)

import requests

proxies = {
    "http": "socks5://127.0.0.1:20134",
    "https": "socks5://127.0.0.1:20134",
}
r = requests.get("https://example.com", proxies=proxies)
print(r.status_code)

Node.js (undici)

import { ProxyAgent, request } from 'undici'

const agent = new ProxyAgent('http://127.0.0.1:20250')
const { statusCode } = await request('https://example.com', { dispatcher: agent })
console.log(statusCode)

Telegram (MTProto)

Клиент Telegram не умеет ходить через обычный прокси с подменой отпечатка — он говорит на своём протоколе. Для него открывают порт с протоколом MTProto: снаружи это выглядит как обычный прокси Telegram, а маскировка делает соединение похожим на TLS к постороннему сайту.

  1. В диалоге открытия порта выберите пресет «MTProto» или протокол mtproto.
  2. Включите переключатель «Расширенные» в шапке диалога — без него секция MTProto скрыта. Оставьте секрет пустым, чтобы приложение сгенерировало новый, или впишите свой в канонической форме ee….
  3. Откройте порт. В ответе придёт готовая ссылка tg://proxy?server=…&port=…&secret=… — её и открывают на устройстве с Telegram.
Открыть порт MTProto
curl -X POST -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"port":20443,"protocol":"mtproto",
       "mtproto_camouflage_domain":"www.google.com"}' \
  http://127.0.0.1:8891/api/v1/ports/open
Ответ
{
  "port": 20443,
  "protocol": "mtproto",
  "status": "opened",
  "tg_link": "tg://proxy?server=203.0.113.10&port=20443&secret=ee…",
  "mtproto_secret": "ee…"
}
  • Домен маскировки — он же SNI, который предъявляет клиент: по умолчанию www.google.com. Со стороны сети соединение похоже на обычный визит на этот сайт.
  • Сканера или клиента с неверным секретом порт по умолчанию отправляет на НАСТОЯЩИЙ сайт маскировки, а не обрывает: обрыв сам по себе выдал бы, что здесь прокси.
  • Если ВЫШЕСТОЯЩИЙ выход сам является прокси MTProto, режим выхода faketls заставляет порт говорить с ним по фальшивому TLS; auto выбирает сам, obfuscated — обычная обфускация.
  • Порт MTProto — не HTTP-прокси: указать его браузеру или curl нельзя, и подмена отпечатка TLS к нему не применяется.

n8n

Для n8n есть готовый узел: пакет n8n-nodes-blanktrail ставится из npm через «Settings → Community nodes». Узел открывает порт, выбирает браузерный профиль и маршрут и отдаёт адрес прокси следующему шагу сценария — без собственного HTTP-кода и без ручных вызовов API.

СоветЕсли BlankTrail и n8n работают в контейнерах, поднимайте их в одной сети Docker и указывайте адрес прокси по имени контейнера, а не через 127.0.0.1 — этот адрес внутри контейнера n8n ведёт в него самого.

Типичные проблемы с подключением

  • Ошибки сертификата на HTTPS — сертификату не доверяют на этом устройстве. Установите его (Установка → Корневой сертификат).
  • Соединение отклонено (Connection refused) — порт не открыт, либо указан неверный хост/порт. Проверьте вкладку «Обзор».
  • Неверный протокол — порт SOCKS5 не примет настройки HTTP-прокси и наоборот. Используйте протокол, указанный у порта.
  • Отказ авторизации на прокси — на портах включён логин с паролем, а в адресе их нет. Пишите адрес целиком: socks5://пользователь:пароль@127.0.0.1:20134. В рекомендованной команде запуска Docker пароль ставится по умолчанию.
  • Порт был и пропал — порт без трафика закрывается сам через 30 минут, и отсчёт идёт с момента открытия. Задайте порту своё время (PUT /api/v1/port/{port}/idle с {"seconds": 0}) или перечислите порт в portmanager.startup_ports.
  • Всё работает, но сайт узнаёт клиента — проверьте, не включён ли на порту сквозной пропуск TLS: с ним наружу уходит отпечаток вашего собственного приложения, а не выбранный профиль.