# ShardX Launcher

{% hint style="info" %}
ShardX Launcher распространяется по лицензии MIT как бесплатный инструмент для личного использования. Программа поставляется «как есть». Мы регулярно выпускаем обновления, но поддержку в лайв-чате не оказываем — при серьёзных проблемах создайте баг-репорт на [GitHub](https://github.com/ProxyShard/ShardBrowser/issues).
{% endhint %}

## Системные требования

### Windows

| Компонент        | Минимум                                | Рекомендуется                                 |
| ---------------- | -------------------------------------- | --------------------------------------------- |
| ОС               | Windows 10 22H2 или Windows 11, 64-бит | Windows 11 64-бит                             |
| Архитектура      | x64 / x86\_64                          | x64                                           |
| Процессор        | Двухъядерный 64-бит, поддержка SSE3    | Четырёхъядерный и выше                        |
| ОЗУ              | 4 ГБ                                   | 8 ГБ (16 ГБ при работе с множеством профилей) |
| Место на диске   | 1 ГБ                                   | 5 ГБ+                                         |
| Среда выполнения | Microsoft Edge WebView2                | —                                             |

### macOS

| Компонент      | Минимум                    | Рекомендуется               |
| -------------- | -------------------------- | --------------------------- |
| ОС             | macOS 11 Big Sur или новее | Последняя стабильная версия |
| Процессор      | Apple Silicon M1 или новее | Apple M2 или новее          |
| ОЗУ            | 4 ГБ                       | 8 ГБ и более                |
| Место на диске | 1 ГБ                       | 5 ГБ+                       |

{% hint style="warning" %}
Текущая сборка собрана под `aarch64-apple-darwin`. Mac на Intel не поддерживается.
{% endhint %}

***

## Установка на Windows

Скачайте последнюю версию:

{% embed url="<https://github.com/ProxyShard/ShardBrowser/releases/latest>" %}

В разделе <mark style="color:purple;">**Assets**</mark> выберите файл <mark style="color:purple;">`.exe`</mark> или <mark style="color:purple;">`.msi`</mark>.

<figure><img src="/files/J5qDbUY7F20UJl3vtSrU" alt=""><figcaption><p>Выберите .exe или .msi в разделе Assets</p></figcaption></figure>

Запустите скачанный файл. <mark style="color:purple;">Windows SmartScreen</mark> может показать предупреждение — нажмите <mark style="color:purple;">**Подробнее**</mark>, затем <mark style="color:purple;">**Выполнить в любом случае**</mark>.

<figure><img src="/files/z7c6us91fo3JGUjAIh8e" alt=""><figcaption><p>SmartScreen — нажмите «Run anyway»</p></figcaption></figure>

Установщик завершит работу за несколько секунд.

<figure><img src="/files/6Ki5rwViPnp3GXKKRDpe" alt=""><figcaption><p>Установка завершена</p></figcaption></figure>

***

## Установка на macOS

Скачайте последнюю версию:

{% embed url="<https://github.com/ProxyShard/ShardBrowser/releases/latest>" %}

В разделе <mark style="color:purple;">**Assets**</mark> выберите файл <mark style="color:purple;">`aarch64.dmg`</mark>.

<figure><img src="/files/FIK4WzXjWFjYPnyTO0ED" alt=""><figcaption><p>Выберите aarch64.dmg в разделе Assets</p></figcaption></figure>

Откройте скачанный `.dmg` и перетащите <mark style="color:purple;">**ShardX Launcher**</mark> в папку <mark style="color:purple;">**Applications**</mark>.

<figure><img src="/files/wmHpsALOccXKBGPNuM1O" alt=""><figcaption><p>Перетащите иконку в Applications</p></figcaption></figure>

### Снятие блокировки Gatekeeper

{% hint style="warning" %}
Этот шаг обязателен. macOS блокирует все неподписанные приложения — без него приложение не откроется.
{% endhint %}

Откройте <mark style="color:purple;">**Терминал**</mark> одним из двух способов:

* <mark style="color:purple;">**Spotlight:**</mark> нажмите `⌘ + Пробел`, введите `terminal`, выберите приложение

<figure><img src="/files/LetiGQPNUSce7ZJ0zusB" alt=""><figcaption><p>Поиск Терминала через Spotlight</p></figcaption></figure>

* <mark style="color:purple;">**Finder:**</mark> Программы (Applications) -> Утилиты (Utilities) -> Терминал

Вставьте команду и нажмите <mark style="color:purple;">**Enter:**</mark>

```bash
xattr -dr com.apple.quarantine "/Applications/ShardX Launcher.app"
```

<figure><img src="/files/GAAdswPtYo3ykpXQrdt5" alt=""><figcaption><p>Команда выполнится без вывода — это нормально</p></figcaption></figure>

После этого откройте приложение через <mark style="color:purple;">Spotlight</mark> (`⌘ + Пробел` → `shardx`) или из папки <mark style="color:purple;">Applications</mark>.

<figure><img src="/files/HR6BQxGiohhn8KrEPAMC" alt=""><figcaption><p>Запуск ShardX через Spotlight</p></figcaption></figure>

***

## Первый запуск

При первом запуске ShardX скачает браузерный движок с CDN (около 198 МБ, один раз). Подождите завершения загрузки.

<figure><img src="/files/f9vdsvS387IDoD7EDLTM" alt=""><figcaption><p>Загрузка движка при первом запуске</p></figcaption></figure>

После загрузки откроется главный экран <mark style="color:purple;">**Browsers**</mark>.

<figure><img src="/files/sSP0D6ylhZ8qdi2UP0L1" alt=""><figcaption><p>Главный экран ShardX Launcher</p></figcaption></figure>

***

## Добавляем прокси

Перейдите в раздел <mark style="color:purple;">**Proxies**</mark> и нажмите <mark style="color:purple;">**+ New proxy**</mark>.

<figure><img src="/files/oZrGZXpK7HSlLNSRIKla" alt=""><figcaption><p>Раздел Proxies</p></figcaption></figure>

В окне <mark style="color:purple;">**Bulk import proxies**</mark> вставьте прокси по одному на строку. Поддерживаемые форматы:

```
host:port
host:port:user:pass
scheme://host:port
scheme://user:pass@host:port
```

<figure><img src="/files/FEDD6Fgt3w2iYcHEuycV" alt=""><figcaption><p>Вставьте прокси по одному на строку</p></figcaption></figure>

Нажмите <mark style="color:purple;">**Test all**</mark>, чтобы проверить прокси перед импортом.

<figure><img src="/files/ZkCI8VaBQRqS6q2eJWOM" alt=""><figcaption><p>Нажмите «Test all» для проверки, затем «Import»</p></figcaption></figure>

После теста каждый прокси получит статус. Прокси с меткой <mark style="color:purple;">**UDP**</mark> поддерживают <mark style="color:purple;">SOCKS5 UDP</mark>, а значит и <mark style="color:purple;">WebRTC</mark> — что очень полезно при работе с серьёзными антифрод-системами. Если метки <mark style="color:purple;">**UDP**</mark> нет, профиль браузера автоматически переходит в режим <mark style="color:purple;">**TCP-only**</mark>: IP не утечёт, однако трафик может выглядеть подозрительно для продвинутых антифрод-систем. Мы крайне советуем использовать [прокси с поддержкой UDP](/proxyshard/nashi-produkty/about-udp.md).

Нажмите <mark style="color:purple;">**Import**</mark> — прокси появится в списке со статусом <mark style="color:purple;">**Active**</mark>.

<figure><img src="/files/oGVyb39k3iqSrntcMlpz" alt=""><figcaption><p>Прокси добавлен</p></figcaption></figure>

***

## Создаём первый профиль

Перейдите в раздел <mark style="color:purple;">**Browsers**</mark> и нажмите <mark style="color:purple;">**+ New profile**</mark>.

<figure><img src="/files/cWsB37KXWH7CEY9BEddj" alt=""><figcaption><p>Раздел Browsers</p></figcaption></figure>

Параметры по умолчанию менять не нужно — ShardX сам сгенерирует уникальный <mark style="color:purple;">отпечаток (fingerprint)</mark>. Обязательно выберите прокси в поле <mark style="color:purple;">**Proxy**</mark> внизу формы.

<figure><img src="/files/2S9lfLiWi10Jb2ocmU3x" alt=""><figcaption><p>Выберите прокси и нажмите «Create profile»</p></figcaption></figure>

Нажмите <mark style="color:purple;">**Create profile**</mark>.

<figure><img src="/files/pq5NwjHLp7FxJ6efaYuG" alt=""><figcaption><p>Профиль создан</p></figcaption></figure>

***

## Запуск профиля

Нажмите <mark style="color:purple;">**Start**</mark> — браузер запустится с изолированным отпечатком и прокси.

<figure><img src="/files/FfWfFu5a4Myj0czRTcZp" alt=""><figcaption><p>Профиль запущен</p></figcaption></figure>

***

## Возможные проблемы

### Windows: приложение не запускается

Скорее всего, не установлен <mark style="color:purple;">Microsoft Edge WebView2 Runtime</mark>. Скачайте и установите его:

{% embed url="<https://developer.microsoft.com/en-us/microsoft-edge/webview2/consumer>" %}

На оригинальных образах Windows 10/11 WebView2 уже включён. На урезанных сборках он может быть удалён.

### macOS: «ShardX Launcher повреждён и не может быть открыт»

Стандартная блокировка <mark style="color:purple;">Gatekeeper</mark>. Следуйте шагам в разделе [Снятие блокировки Gatekeeper](#снятие-блокировки-gatekeeper) — там описаны оба способа открыть Терминал и команда для снятия карантина.

***

## Что дальше?

* **Автоматизация:** управляйте профилями через [локальный HTTP API](/proxyshard/nashi-produkty/shardx-launcher.md) на `127.0.0.1:40325`
* **MCP-сервер:** скачайте из настроек (<mark style="color:purple;">Settings -> MCP server</mark>) для управления профилями через AI-агента


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.proxyshard.com/proxyshard/instrukciya-po-ispolzovaniyu/shardx-browser.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.