# ITG Ray (Windows, Linux)

После этой страницы у вас будет установлен ITG Ray, добавлена подписка Underground и настроен роутинг.

[ITG Ray](https://github.com/IvanTopGaming/ITG_Ray) — быстрый современный VLESS-клиент для Windows и Linux на базе sing-box и Xray-core. Имеет чистый интерфейс, встроенный системный хелпер (GUI никогда не требует запуска от root), поддержку TUN-режима, системного прокси и визуальный редактор роутинга.

> **Приоритет поддержки:** Клиент ITG Ray входит в число основных клиентов сервиса и **поддерживается в первую очередь**. Поддержка сторонних клиентов не гарантирована и зависит от их разработчиков.

## Установка

- **Windows:** скачайте и запустите установщик latest-релиза [ITGRay-Setup-0.1.2-beta.1.exe](https://github.com/IvanTopGaming/ITG_Ray/releases/download/v0.1.2-beta.1/ITGRay-Setup-0.1.2-beta.1.exe) (все версии доступны на [странице релизов](https://github.com/IvanTopGaming/ITG_Ray/releases)).
- **Linux:**
  - **Arch Linux (AUR):**
    ```bash
    yay -S itgray-bin
    sudo systemctl enable --now itgray-helper.service
    ```
  - **AppImage:** скачайте [ITGRay-0.1.2-beta.1.AppImage](https://github.com/IvanTopGaming/ITG_Ray/releases/download/v0.1.2-beta.1/ITGRay-0.1.2-beta.1.AppImage), сделайте файл исполняемым (`chmod +x ITGRay-*.AppImage`) и запустите.

### Установка системного хелпера (Служба)

Для работы полноценного TUN-режима (виртуальный сетевой адаптер, туннелирующий весь трафик системы, игры и приложения без прав root у GUI) в ITG Ray используется отдельный системный хелпер.

Если хелпер не установился автоматически:

1. Откройте **Настройки** в левом боковом меню ITG Ray.
2. Прокрутите страницу вниз до раздела **Служба** (Хелпер / Helper).
3. Нажмите кнопку **«Установить»** (система запросит подтверждение прав администратора — подтвердите UAC в Windows или polkit в Linux).
4. Когда статус станет зеленым («Работает»), хелпер готов, и TUN-режим полностью доступен.

## Добавление подписки

1. Скопируйте ссылку-подписку из Telegram-бота [@itg_gateway_bot](https://t.me/itg_gateway_bot) (кнопка **Моя подписка**).
2. В ITG Ray перейдите в список серверов и нажмите кнопку добавления подписки (или вставьте ссылку из буфера).
3. Клиент загрузит список актуальных нод Underground.

## Подключение

1. Выберите режим работы:
   - **TUN** (рекомендуется) — полный туннель для всего трафика системы через виртуальный интерфейс с FakeIP DNS;
   - **Системный прокси** — направляет через прокси только системный HTTP/SOCKS трафик.
2. Выберите сервер и нажмите «Подключить».

## Что дальше

Следующий шаг — настройка маршрутизации, чтобы российские сервисы и реклама обрабатывались корректно:
👉 [Пресет роутинга для ITG Ray](../routing/itg-ray-rules.md).