Skip to content

Instantly share code, notes, and snippets.

@kksudo
Last active March 18, 2026 11:07
Show Gist options
  • Select an option

  • Save kksudo/9e2072b3c60a72040f4e9d6fb9da7e9c to your computer and use it in GitHub Desktop.

Select an option

Save kksudo/9e2072b3c60a72040f4e9d6fb9da7e9c to your computer and use it in GitHub Desktop.
Настраиваем подключение к впн Устанавливайте только Stable версии приложений!

Настраиваем подключение к VPN

Используйте только Stable-версии приложений!

Кратко

Установите приложение для вашего устройства, импортируйте ключ (или отсканируйте QR-код) и включите подключение. Ключ или ссылку на подписку вы получаете от администратора — сами приложения лишь подключаются к серверу по этому ключу.


Навигация

Раздел Описание
Самый быстрый способ (HAPP) Один клик — и VPN с правильной маршрутизацией уже работает
Приложения по платформам iOS, Android, Windows, macOS, Linux
Подробные инструкции Пошаговые настройки для каждого приложения
Маршрутизация (.ru напрямую) Как не тратить трафик VPN на российские сайты
Ограничения и правила Лимиты аккаунта и допустимое использование
Альтернативы и FAQ Другие клиенты, Tor, ответы на вопросы

⚡ Самый быстрый способ — HAPP + готовые правила маршрутизации

Почему HAPP рекомендуется в первую очередь? HAPP — это кроссплатформенный клиент (iOS, Android, Windows, macOS, Linux), построенный на ядре XRay, который поддерживает автоматический импорт правил маршрутизации через deeplink. Это значит, что вам не придётся вручную настраивать, какие сайты ходят через VPN, а какие — напрямую. Одна ссылка — и всё работает правильно: российские сайты открываются напрямую (быстро и без расхода VPN-трафика), а заблокированные — через VPN.

Как настроить (3 шага)

Шаг 1. Установите HAPP на ваше устройство:

Платформа Где скачать
iOS App Store
Android Google Play или happ.su
Windows Windows x64
macOS macOS
Linux deb / rpm / pkg

Шаг 2. Импортируйте ваш ключ подписки: откройте HAPP → нажмите «+» → вставьте ключ из буфера обмена или отсканируйте QR-код.

Шаг 3. Загрузите готовые правила маршрутизации — откройте эту ссылку прямо на устройстве, где установлен HAPP:

🔗 routing.help — откройте в браузере на устройстве с HAPP

Эта ссылка автоматически откроет HAPP и загрузит набор правил RoscomVPN Routing. Правила обновляются ежедневно и включают:

  • Напрямую (без VPN): российские сайты (.ru), Microsoft, Apple, Google Play, Steam, Epic Games, Riot, Twitch, Pinterest, Faceit
  • Через VPN: YouTube, Telegram, GitHub
  • Блокируются: реклама, торренты, шпионские трекеры Windows

Подробнее о правилах: github.com/hydraponique/roscomvpn-routing

Готово! Включите подключение в HAPP и пользуйтесь. Если HAPP вам не подходит — ниже есть альтернативные приложения для каждой платформы.


Приложения по платформам

Если вы уже установили HAPP по инструкции выше — этот раздел можно пропустить. Ниже перечислены альтернативные приложения.

iOS

Приложение Описание Ссылка
Happ Универсальный клиент, поддержка deeplink-маршрутизации App Store
FoXray XRay-клиент для iOS App Store
V2Box V2Ray-клиент App Store

Android

Приложение Описание Ссылка
Happ Поддержка подписки по ссылке/QR и deeplink-маршрутизации Google Play / happ.su
FlClashX Форк FlClash на ClashMeta, простой и без рекламы, open source GitHub
Clash Meta Мощный Clash-клиент с поддержкой подписок GitHub
NekoBox Универсальный клиент GitHub
V2RayNG Классический V2Ray-клиент Google Play / GitHub
v2RayTun Классический V2Ray-клиент Google Play

Windows

Приложение Описание Ссылка
Happ Универсальный клиент с deeplink-маршрутизацией happ.su
Koala Clash Современный GUI-клиент на Tauri GitHub
FlClashX Форк FlClash на ClashMeta, простой и без рекламы GitHub
Clash Meta Clash-клиент GitHub
NekoRay / NekoBox Десктоп-клиент (Qt, sing-box). ⚠️ Репозиторий архивирован, обновлений не будет GitHub

macOS

Приложение Описание Ссылка
Happ Универсальный клиент с deeplink-маршрутизацией happ.su
Koala Clash Современный GUI-клиент на Tauri GitHub
FlClashX Форк FlClash на ClashMeta, простой и без рекламы GitHub
NekoRay Аналогично Windows. ⚠️ Репозиторий архивирован GitHub
V2Box V2Ray-клиент App Store

Linux

Приложение Описание Ссылка
Happ Универсальный клиент с deeplink-маршрутизацией (deb, rpm, pkg) happ.su
Koala Clash Современный GUI-клиент на Tauri GitHub
FlClashX Форк FlClash на ClashMeta, простой и без рекламы GitHub
NekoRay Аналогично Windows. ⚠️ Репозиторий архивирован GitHub

Подробные инструкции по клиентам

HAPP (iOS, Android, Windows, macOS, Linux) — рекомендуемый

  1. Скачайте и установите HAPP (App Store / Google Play / happ.su).
  2. Откройте приложение и нажмите «+».
  3. Вставьте ключ подписки из буфера обмена или отсканируйте QR-код.
  4. Перейдите по ссылке routing.help на этом же устройстве — правила маршрутизации загрузятся автоматически.
  5. Включите подключение. Готово!

V2RayNG (Android)

  1. Установите из Google Play или GitHub.
  2. Откройте приложение → кнопка «+» (добавить).
  3. Выберите «Импорт профиля из QR-кода» и отсканируйте QR, либо вставьте ссылку/ключ из буфера обмена.
  4. Нажмите на профиль, чтобы его активировать, и включите подключение.

NekoBox (Android)

  1. Скачайте и установите: NekoBox for Android.
  2. Скопируйте ключ подписки в буфер обмена.
  3. Откройте приложение → нажмите «+» вверху → «Импорт из буфера обмена».
  4. Нажмите на иконку подключения внизу экрана и запустите профиль.

FoXray (iOS)

  1. Установите из App Store.
  2. Откройте FoXray → нажмите «+» или выберите сканирование QR-кода.
  3. Отсканируйте QR-код с настройками (например, с экрана компьютера).
  4. Нажмите «Play» и разрешите приложению добавить VPN-конфигурацию на устройство.

V2Box (iOS / macOS)

  1. Установите из App Store.
  2. Откройте V2Box → «+» / «Add» → «Import url from clipboard» и вставьте ключ подписки.
  3. Вернитесь на главный экран и нажмите «Connect».
  4. Разрешите приложению добавить VPN-конфигурацию.
  5. Проверка: откройте 2ip.ru или whatismyipaddress.com.

NekoRay / NekoBox for PC (Windows / macOS / Linux)

⚠️ Репозиторий MatsuriDayo/nekoray архивирован автором, обновлений не будет. Рекомендуем HAPP, Koala Clash или FlClashX как альтернативу.

  1. Скачайте и распакуйте: NekoRay.
  2. Запустите nekoray.exe (или соответствующий файл для вашей ОС).
  3. Скопируйте ключ подписки в буфер обмена.
  4. В программе: Сервер → Добавить профиль из буфера обмена.
  5. Правый клик по профилю → Запустить.
  6. Для проксирования всего трафика включите режим TUN (на macOS может потребоваться запуск от root).

Альтернативное ядро: в настройках можно указать ядро sing-box: Preference → Basic settings → Core.


Маршрутизация (.ru напрямую)

Чтобы российские сайты открывались напрямую (быстрее и без расхода VPN-трафика):

Способ 1: HAPP + deeplink (рекомендуемый)

Просто перейдите по ссылке routing.help на устройстве с установленным HAPP — все правила загрузятся автоматически. Подробнее см. раздел «Самый быстрый способ».

Способ 2: NekoRay (ручная настройка)

  1. Откройте Preferences → Routing settings → Simple route → Custom route.
  2. Откройте Json Editor и добавьте:
{
  "rules": [
    {
      "domain_suffix": [".ru"],
      "outbound": "direct"
    }
  ]
}

Способ 3: FoXray (iOS)

  1. Вверху главного экрана откройте Routing & DNS.
  2. Выберите набор правил Simple и настройте правило для доменов .rudirect.
  3. Сохраните и включите подключение.

Проверка: откройте 2ip.ru или whatismyipaddress.com — IP должен быть российским.


Ограничения и правила

  • Устройства: не более 3 одновременных подключений на один аккаунт (уточняйте у администратора).
  • Трафик: лимит ~150 ГБ в месяц (зависит от тарифа).
  • Использование: не используйте VPN для незаконной деятельности, спама, распространения вредоносного ПО или запрещённого контента. Пользуйтесь сервисом ответственно.

Альтернативы и FAQ

Бесплатные альтернативы для обхода блокировок

⚠️ Трафик через сторонние сервисы обрабатывается по их правилам. Учитывайте политику конфиденциальности каждого сервиса.

FAQ

Что за VPN мы настраиваем? Используется панель 3X-UI и протокол XRay XTLS-Reality — современная разработка, маскирующая трафик под обычный HTTPS. Подробнее: Habr — XTLS-Reality, Habr — 3X-UI.

Как это работает? Трафик шифруется и «прячется» за чужим доменом. Ваш провайдер видит обычный HTTPS-трафик к стороннему сайту, что затрудняет обнаружение и блокировку.

В чём преимущества? Хорошая совместимость с сотовыми провайдерами в РФ. VLESS мимикрирует под обычный HTTPS. 3X-UI даёт гибкие настройки и повышенную стойкость к блокировкам.

Собирает ли сервис данные? Данные пользователей сервис не собирает и не монетизирует (уточняйте у владельца панели/администратора).

@extrifixation
Copy link

extrifixation commented Nov 10, 2024

а на nekobox как-то можно кинуть весь трафик напрямую, кроме указанных в маршрутах доменов, которые мне нужно гонять через прокси?

@kksudo
Copy link
Author

kksudo commented Nov 10, 2024

nekobox

MatsuriDayo/nekoray#738 (comment)

MacOS X Tun mode works in sudo
something like
sudo /Applications/nekoray_arm64.app/Contents/MacOS/nekoray

@kksudo
Copy link
Author

kksudo commented Nov 10, 2024

а на nekobox как-то можно кинуть весь трафик напрямую, кроме указанных в маршрутах доменов, которые мне нужно гонять через прокси?

You need these settings:
image

@extrifixation
Copy link

а на nekobox как-то можно кинуть весь трафик напрямую, кроме указанных в маршрутах доменов, которые мне нужно гонять через прокси?

You need these settings: image

I have configured it on the PC, how about android?

@kksudo
Copy link
Author

kksudo commented Nov 10, 2024

I have configured it on the PC, how about android?

For android, I can recommend you v2rayNG, it's a pretty stable and simple tool.

@extrifixation
Copy link

I have configured it on the PC, how about android?

For android, I can recommend you v2rayNG, it's a pretty stable and simple tool.

v2rayNg does not support this routing method either.

@kksudo
Copy link
Author

kksudo commented Nov 11, 2024

v2rayNg does not support this routing method either.

I'm sorry, I don't know anything about the topic you mentioned. If someone else has a solution, please let me know by updating this thread.

@extrifixation
Copy link

extrifixation commented Nov 11, 2024

S41111-15360396
it worked this way
ip:0.0.0.0/0
outbound:direct

@flarens
Copy link

flarens commented Dec 6, 2024

Подскажите как в Windows версии nekoray настроить маршрутизацию, чтобы все процессы были baypass (напрямую), кроме процесса chrome.exe, НО в самом хроме чтобы весь трафик тоже шел напрямую за исключением указанного списка суфиксов доменов. Такое вообще возможно в нем настроить?

@kksudo
Copy link
Author

kksudo commented Dec 6, 2024

Подскажите как в Windows версии nekoray настроить маршрутизацию, чтобы все процессы были baypass (напрямую), кроме процесса chrome.exe, НО в самом хроме чтобы весь трафик тоже шел напрямую за исключением указанного списка суфиксов доменов. Такое вообще возможно в нем настроить?

Для таких задач (сам использую в таком же кейсе) реоменую использовтаь расширение для прокси Proxy SwitchyOmega.

Т.е. получается, что весь трафик идет напрямую, но в настройках Proxy мы указываем список доменов, которые должны ходить через наш VPN. Как раз в этом расширении можно добавлять правила regexp, для которых трафик должен идти через VPN.

Nekoray запускает http proxy and socks proxy на локалхост, а в браузере в расширении в указываете способ подключения к VPN.
image

@extrifixation
Copy link

extrifixation commented Dec 6, 2024

Подскажите как в Windows версии nekoray настроить маршрутизацию, чтобы все процессы были baypass (напрямую), кроме процесса chrome.exe, НО в самом хроме чтобы весь трафик тоже шел напрямую за исключением указанного списка суфиксов доменов. Такое вообще возможно в нем настроить?

image
image_2024-12-06_16-11-33

В "Настройках маршрута > Базовые маршруты", каждый домен с новой строки через приставку "domain:" в столбик с "Прокси", в этом же окне, внизу указываешь outbound по умолчанию - "bypass". Ставишь на главном экране режим TUN и в меню "Программа" ставишь галочку запомнить последний профиль.

@flarens
Copy link

flarens commented Dec 7, 2024

реоменую использовтаь расширение для прокси

Интересное решение, но сейчас обнаружил проблему, что в режиме системного прокси NekoRay конфликтует с моим файерволом SimpleWall (работает на основе Windows Filtering Platform - WFP). Суть в том, что после включения VPN прокси некоторые запреты фаервола втихую перестают работать. Так ряд программ несанкционированно обновились, что только сейчас заметил. Смена порта прокси не помогла. Сейчас смотрю на режим TUN, который вроде не конфликтует.

А теперь к вопросу. Запускаю VPN TUN (на ютуб стоит bypass), запускаю goodbyedpi и на ютуб не идет интернет. Возможно ли подружить эти 2 решения, чтобы Ютуб трафик не гонять через VPN? Пробовал в настройках TUN-режима добавить пропуск процесса goodbyedpi.exe - не помогает.

@flarens
Copy link

flarens commented Dec 8, 2024

Решил свою проблему. Напишу кратко, вдруг кому пригодится.

NekoRay в режиме системного proxy ломает работу файрволов, работающих на WFP. Изменение порта proxy не помогает. Но сработало изменение ip proxy.

NekoRay - Настройки - Основные настройки
Адрес входящих подключений = 127.0.0.5
Адрес входящих SOCKS = 2085

Примечание: при использовании кастомного прокси в NekoRay не нужно ставить галочки Режим TUN или Режим системного прокси. Он всегда включен по заданному адресу, а рубильник включения делаем в самом браузере через расширение.

Смотрел разные proxy расширения для Хрома, все нагромождены избыточными фрэймворками, не понятно безопасны они или где шпионы зарыты. Требуют каких-то сомнительных доступов. Написал свое расширение - простой переключатель proxy. Единственный функционал - переключение с системного прокси на указанный выше адрес. Код скрипта максимально простой в 1 страницу, легко проверить.

Убитые зайцы:

  1. как и требовалось, VPN трафик идет только через приложения, подключенные по кастомному прокси (в моем случае только Chrome)
  2. такой способ не препятствует работе goodbyedpi

@wildburn
Copy link

а на nekobox как-то можно кинуть весь трафик напрямую, кроме указанных в маршрутах доменов, которые мне нужно гонять через прокси?

You need these settings: image

 Tun mode не работает на маке. Требует постоянно чтобы пароль ввели от судо и все и ничего не происходит постоянно пароль просит

@kksudo
Copy link
Author

kksudo commented Dec 23, 2024

а на nekobox как-то можно кинуть весь трафик напрямую, кроме указанных в маршрутах доменов, которые мне нужно гонять через прокси?

 Tun mode не работает на маке. Требует постоянно чтобы пароль ввели от судо и все и ничего не происходит постоянно пароль просит

Да, на маке есть такой косяк.
Чтобы весь трафик гнать нужно или nekoray от root запускать
Или
Использовать V2Box - V2ray Client, там эта фича работает из коробки.

@wildburn
Copy link

а на nekobox как-то можно кинуть весь трафик напрямую, кроме указанных в маршрутах доменов, которые мне нужно гонять через прокси?

Tun mode не работает на маке. Требует постоянно чтобы пароль ввели от судо и все и ничего не происходит постоянно пароль просит

Да, на маке есть такой косяк. Чтобы весь трафик гнать нужно или nekoray от root запускать Или Использовать V2Box - V2ray Client, там эта фича работает из коробки.

Read-only file system он мне выдает когда тун мод пытаюсь врубить и никак от рута он не запускается)

@Amogususyy
Copy link

@VitaliyAT
Copy link

Решил свою проблему. Напишу кратко, вдруг кому пригодится.

NekoRay в режиме системного proxy ломает работу файрволов, работающих на WFP. Изменение порта proxy не помогает. Но сработало изменение ip proxy.

NekoRay - Настройки - Основные настройки Адрес входящих подключений = 127.0.0.5 Адрес входящих SOCKS = 2085

Примечание: при использовании кастомного прокси в NekoRay не нужно ставить галочки Режим TUN или Режим системного прокси. Он всегда включен по заданному адресу, а рубильник включения делаем в самом браузере через расширение.

Смотрел разные proxy расширения для Хрома, все нагромождены избыточными фрэймворками, не понятно безопасны они или где шпионы зарыты. Требуют каких-то сомнительных доступов. Написал свое расширение - простой переключатель proxy. Единственный функционал - переключение с системного прокси на указанный выше адрес. Код скрипта максимально простой в 1 страницу, легко проверить.

Убитые зайцы:

  1. как и требовалось, VPN трафик идет только через приложения, подключенные по кастомному прокси (в моем случае только Chrome)
  2. такой способ не препятствует работе goodbyedpi

Не понимаю чем не устраивает настройка в самой программе "Всё по байпас, кроме указанных" как показал extrifixation

@VitaliyAT
Copy link

VitaliyAT commented Jan 24, 2025

Сталкиваюсь с проблемой постоянного отключения программы на ПК. Выплёвывает что-то вроде "внешний сайт прервал подключение" или просто лог останавливается и стоит. Руками снова делаешь Старт и всё снова запускается, но тоже до поры до времени. Как в настроить автоматический реконнект?

@kksudo
Copy link
Author

kksudo commented Jan 24, 2025

@VitaliyAT

Сталкиваюсь с проблемой постоянного отключения программы на ПК. Выплёвывает что-то вроде "внешний сайт прервал подключение" или просто лог останавливается и стоит. Руками снова делаешь Старт и всё снова запускается, но тоже до поры до времени. Как в настроить автоматический реконнект?

Да, наблюдал подобное поведение в nekoray. Думаю это связано с типом подключения, это же не постоянный впн, а трафик, который пытается мимикрировать под обычные HTTPS запросы. Думаю в этом причина.
Поэтому, когда нужно стабильное подключение использую V2Box.

@kksudo
Copy link
Author

kksudo commented May 16, 2025

Отличный тред с инструкциями по VLES: XTLS/Xray-core#3518

В данном руководстве мы с Вами подробно рассмотрим настройку VLESS TCP REALITY + FLOW + uTLS, а так же рассмотрим детально механизмы их работы.

@aleksei95
Copy link

Здравствуйте, Я вот не пойму когда я настраивал на v2box на ios двоюродному брату, там кнопка chain есть, а вот у знакомого тоже ios, и у него кнопки chain в v2box нету

@kksudo
Copy link
Author

kksudo commented Dec 27, 2025

Здравствуйте, Я вот не пойму когда я настраивал на v2box на ios двоюродному брату, там кнопка chain есть, а вот у знакомого тоже ios, и у него кнопки chain в v2box нету

Видимо разные версии...
По IOS ничего не подскажу, негде потестировать.
Попробуйте в этой ветке поискать.

@tyrboloto1
Copy link

списки листы где теперь брать , смотрю все стало недоступно

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment