Skip to content

shardx-launcher.md

Latest commit

 

History

History
87 lines (58 loc) · 8.38 KB

shardx-launcher.md

File metadata and controls

87 lines (58 loc) · 8.38 KB
Raw
icon fingerprint

ShardX Launcher

ShardX Browser - наш антидетект-браузер: создавайте профили с уникальными отпечатками (fingerprint), привязывайте к каждому прокси и работайте с десятками аккаунтов как разные люди на разных устройствах. Поверх ручного режима есть локальное API автоматизации для Puppeteer / Playwright.

Скачать и установить

Пошаговая инструкция по установке, настройке прокси и созданию первого профиля:

{% content-ref url="../setup-guides/shardx-browser.md" %} ShardX Launcher - установка и настройка {% endcontent-ref %}

Что умеет ShardX:

  • Генерирует уникальные отпечатки под Windows, macOS и Linux (navigator, screen, client hints, WebGL / WebGPU и т.д.)
  • Шум по отдельным векторам: canvas, WebGL, audio, client rects, шрифты, сенсоры
  • Неограниченное число профилей с раскладкой по папкам
  • Привязка прокси к профилю (SOCKS5 / HTTP / HTTPS) с автотестом при добавлении
  • Локальное HTTP API для полной автоматизации
  • Управление через CDP (Chrome DevTools Protocol) - Puppeteer, Playwright и аналоги
  • Экспорт и импорт cookies между профилями
  • Отдельный MCP-сервер, чтобы профилем мог управлять ИИ-агент

Отпечатки и анти-детект

Для каждого профиля ShardX подставляет согласованный набор параметров: User-Agent, платформу, число ядер и объём памяти (никогда не больше, чем у реальной машины), разрешение экрана, Sec-CH-UA и прочее. Сверху накладывается шум по отдельным векторам - canvas, WebGL, audio, client rects, шрифты, сенсоры. Каждый блок шума включается независимо, так что отпечаток профиля стабилен внутри сессий, но отличается от других профилей и от вашего реального устройства.

{% hint style="info" %} Отпечаток генерируется уникальным и не привязан к железу: число ядер CPU и объём RAM подгоняются под хост и не завышаются, экран обрезается под реальный дисплей. Это снижает риск детекта на нестыковках. {% endhint %}

Прокси, QUIC и WebRTC

ShardX особенно хорошо работает в связке с нашими прокси. При каждом запуске профиля, ещё до старта браузера, привязанный прокси вживую проверяется на поддержку UDP-relay (SOCKS5 UDP_ASSOCIATE):

  • если UDP работает - включается QUIC, а WebRTC ходит через проксированный UDP-relay;
  • если UDP недоступен - QUIC отключается, а WebRTC принудительно переводится в режим TCP-only, чтобы реальный IP не утёк.

Поля часового пояса, локали и геолокации в режиме auto тоже подтягиваются вживую через прокси прямо на запуске.

{% hint style="success" %} Связка ShardX + наши прокси с поддержкой UDP закрывает утечку WebRTC на уровне браузера: UDP-трафик идёт через прокси, а не напрямую с вашего IP. Подробнее про саму проблему - в разделе О протоколе UDP. {% endhint %}

Автоматизация: локальное API

Внутри приложения поднимается локальный HTTP-сервер на 127.0.0.1 (порт по умолчанию 40325, меняется в Settings → Automation API). Снаружи он недоступен - только с вашей машины.

Все запросы, кроме GET /health, требуют Bearer-токен (постоянный JWT из настроек):

Authorization: Bearer <token>

Кнопка Regenerate token в настройках мгновенно меняет секрет: новый токен начинает работать сразу, а все старые перестают действовать.

Типичный сценарий автоматизации:

  1. GET /fingerprint/new/{platform} - получить готовый уникальный отпечаток (без сохранения).
  2. При желании - подправить отпечаток (например, включить шум по шрифтам или сменить режим WebRTC).
  3. POST /profiles - создать профиль с этим отпечатком (сохраняется как есть, без повторной рандомизации) и привязать прокси.
  4. POST /profiles/{id}/start - запустить профиль и получить CDP-эндпоинт.
  5. Подключиться к нему как browserWSEndpoint = cdp.web_socket_debugger_url в Puppeteer / Playwright.
  6. POST /profiles/{id}/stop - закрыть профиль.

{% hint style="info" %} Временные профили. POST /profiles/temporary создаёт профиль с флагом temporary: он скрыт из общего списка и в интерфейсе, а после закрытия браузера удаляется автоматически (вместе с папкой данных). Удобно для одноразовых задач. {% endhint %}

Полное описание всех методов (профили, отпечатки, прокси, папки, cookies, запуск / остановка) с моделями данных и примерами смотрите в спецификации API ShardX Launcher.

MCP-сервер для ИИ-агентов

В комплекте идёт отдельный MCP-сервер (Model Context Protocol): он позволяет ИИ-клиенту управлять лаунчером через это же API, а самим браузером профиля - по CDP. Это отдельный Node-процесс, не часть HTTP API.

Скачать его можно прямо из лаунчера (Settings → MCP server → Download MCP server). Настраивается двумя переменными: SHARDX_API (базовый URL API) и SHARDX_TOKEN (тот самый Bearer-токен). MCP-сервер даёт:

  • API-инструменты - тонкие обёртки над методами лаунчера (профили, отпечатки, прокси, папки, cookies, запуск / остановка);
  • браузерные инструменты поверх CDP - навигация, выполнение JS, скриншоты, клики, ввод текста, работа со вкладками и ожидания.

{% hint style="warning" %} CDP (remote-debugging) включается только при запуске профиля через API. Запуски из интерфейса остаются без отладочного порта - так анти-детект не страдает. {% endhint %}