> For the complete documentation index, see [llms.txt](https://docs.proxyshard.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.proxyshard.com/ua/instrukciyi-z-vikoristannya/shardx-browser.md).

# 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/6UZ3Mv7ZdHQ51EcWHQZ9" 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/kqHh02OzwBAqvHF0wQ4O" alt=""><figcaption><p>SmartScreen — натисніть «Run anyway»</p></figcaption></figure>

Встановлювач завершить роботу за кілька секунд.

<figure><img src="/files/Wl502xeAwdNByhT3Y9jb" 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/Ve2oBVkDsnbtj9aTbAW8" 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/GbXWYbUqtVs7sAHtsAxN" 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/GFqSCsoAHyqeR8CXsLk8" 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/KHDnvXCNbxF0FMngCTDu" alt=""><figcaption><p>Команда виконається без виводу — це нормально</p></figcaption></figure>

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

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

***

## Перший запуск

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

<figure><img src="/files/Z0P4qSBlZhlAKOseFHAf" alt=""><figcaption><p>Завантаження рушія при першому запуску</p></figcaption></figure>

Після завантаження відкриється головний екран <mark style="color:purple;">**Browsers**</mark>.

<figure><img src="/files/EWPnPS2oVXJeLspNH4UO" 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/DNZyWQ7XNF2w27ppnEV9" 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/MpI9jXvAfRtpcoKRwSgA" alt=""><figcaption><p>Вставте проксі по одному на рядок</p></figcaption></figure>

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

<figure><img src="/files/xfoNWw4z3P3Jf9aBVAoF" 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](/ua/nashi-produkti/about-udp.md).

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

<figure><img src="/files/zHi6PwiMXlmssqbViW9V" alt=""><figcaption><p>Проксі додано</p></figcaption></figure>

***

## Створюємо перший профіль

Перейдіть до розділу <mark style="color:purple;">**Browsers**</mark> і натисніть <mark style="color:purple;">**+ New profile**</mark>.

<figure><img src="/files/ktZn4j12iLfFaOyWhpQm" alt=""><figcaption><p>Розділ Browsers</p></figcaption></figure>

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

<figure><img src="/files/vNa3QcNiVeXfsF1Yqo27" alt=""><figcaption><p>Виберіть проксі і натисніть «Create profile»</p></figcaption></figure>

Натисніть <mark style="color:purple;">**Create profile**</mark>.

<figure><img src="/files/3McfwTdfeiiXM9ShT80C" alt=""><figcaption><p>Профіль створено</p></figcaption></figure>

***

## Запуск профілю

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

<figure><img src="/files/PLD30uvXJcyNjCCmXwYy" 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](/ua/nashi-produkti/shardx-launcher.md) на `127.0.0.1:40325`
* **MCP-сервер:** завантажте з налаштувань (<mark style="color:purple;">Settings -> MCP server</mark>) для керування профілями через AI-агента


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/ua/instrukciyi-z-vikoristannya/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.