Skip to content

Instantly share code, notes, and snippets.

@kksudo
Last active February 4, 2026 09:01
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 (3X-UI / XRay)

Кратко: установите приложение под вашу платформу, импортируйте ключ или QR и включите подключение.

Важно: используйте только Stable-версии приложений. Клиенты не предоставляют серверы — ключ/подписку вы получаете отдельно.


Навигация

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

Быстрый старт

  1. Установите приложение для вашей платформы из раздела Приложения по платформам.
  2. Скопируйте ключ подписки или откройте QR-код (ключ обычно выдаёт администратор или панель 3X-UI).
  3. Импортируйте конфигурацию в приложении (из буфера обмена или по QR) и включите подключение.

Подробнее про клиенты и протоколы: Habr — настройка 3X-UI.


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

Рекомендованные клиенты для подписки:

iOS

Приложение Описание Ссылка
Happ Универсальный прокси-клиент, поддержка VLESS/Reality, VMess, Trojan и др. App Store
FoXray XRay-клиент для iOS App Store
V2Box V2Ray-клиент App Store

Android

Приложение Описание Ссылка
Happ Тот же клиент, что и на iOS; поддержка подписки по ссылке/QR Google Play / happ.su
Clash Meta Мощный Clash-клиент с поддержкой подписок GitHub / Clash Meta
FlClashX Форк FlClash на ClashMeta: многоплатформенный прокси-клиент, простой и удобный, open source, без рекламы GitHub FlClashX
NekoBox Универсальный клиент (NekoRay-подобный) GitHub NekoBox
V2RayNG Классический V2Ray-клиент Google Play / GitHub

Windows

Приложение Описание Ссылка
Koala Clash Современный GUI-клиент на Tauri для Windows, macOS и Linux с гибкой настройкой прокси GitHub Koala Clash
Clash Meta / FlClashX Clash-клиенты: FlClashX — форк FlClash на ClashMeta, простой, open source, без рекламы Clash Meta, FlClashX
Happ Универсальный клиент happ.su
NekoRay / NekoBox Полнофункциональный десктоп-клиент (Qt, backend: sing-box). Репозиторий архивирован, обновлений нет GitHub NekoRay

macOS

Приложение Описание Ссылка
Koala Clash Современный GUI-клиент на Tauri для Windows, macOS и Linux с гибкой настройкой прокси GitHub Koala Clash
Happ Универсальный клиент happ.su
FlClashX Форк FlClash на ClashMeta: многоплатформенный прокси-клиент, простой и удобный, open source, без рекламы GitHub FlClashX
NekoRay for macOS NekoRay под macOS GitHub
V2Box V2Ray-клиент App Store

Linux

Приложение Описание Ссылка
Koala Clash Современный GUI-клиент на Tauri для Windows, macOS и Linux с гибкой настройкой прокси GitHub Koala Clash
NekoRay Аналогично Windows. Репозиторий архивирован, обновлений нет GitHub NekoRay
FlClashX Форк FlClash на ClashMeta: многоплатформенный прокси-клиент, простой и удобный, open source, без рекламы GitHub FlClashX

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

Android

NekoBox for Android

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

V2RayNG

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

V2RayNG — добавление

iOS

FoXray

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

  • Открыть приложение FoXray и нажать кнопку "+" (позволит добавить конфигурацию вручную) или отсканировать QR-код image

  • Необходимо сканировать QR-код с настройками для подключения (например с компьютера)

  • Нажать кнопку "Play" и разрешить приложению добавить конфигурацию VPN на устройство image

V2Box

  1. Установите из App Store.
  2. Откройте V2Box → «Add»«Import from QR Code» или вставьте ссылку из буфера.
  3. Отсканируйте QR или вставьте конфигурацию и включите подключение.

Windows

NekoRay / NekoBox for PC

Примечание: репозиторий MatsuriDayo/nekoray архивирован автором, последние коммиты — около двух лет назад. Клиент по-прежнему можно скачать и использовать, но новых версий не ожидается; при выборе клиента учтите альтернативы (Koala Clash, FlClashX, NekoBox for Android).

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

Альтернатива (другое ядро):

  1. При установке/настройке укажите ядро sing-box. В уже установленном: Preference → Basic settings → Core.
  2. Program → Scan QR Code — отсканируйте QR.
  3. Включите VPN Mode и запустите профиль (правый клик → Start).

macOS

NekoRay for macOS

Настройка аналогична Windows: NekoRay for macOS.

V2Box

  1. Установите из App Store.
  2. Откройте V2Box → «+» / «Add»«Import url from clipboard» и вставьте скопированную ссылку подписки.
  3. На главном экране нажмите «Connect» и разрешите добавление VPN-конфигурации.
  4. Проверка: 2ip.ru, whatismyipaddress.com.
Открыть картинку
  1. Скачать и установить приложение на компьютер. Можно установить из AppStore https://apps.apple.com/us/app/v2box-v2ray-client/id6446814690
  2. Открыть приложение V2Box и нажать кнопку "+" "Add", выбрать опцию "Import url from clipboard" и вставить скопированную конфигурацию image
  3. Вернуться на главный экран (Значок дом). Нажать кнопку "Connect" и разрешить приложению добавить конфигурацию VPN на устройство. image
  4. Проверить подключение можно на сайтах https://2ip.ru и https://whatismyipaddress.com/ image

Linux

Настройка NekoRay for Linux аналогична Windows.


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

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

NekoRay

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

FoXray (iOS)

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

Проверка: 2ip.ru, whatismyipaddress.com.

Подробнее: Пикабу — настройка 3X-UI, часть 2.


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

  • Устройства: на один аккаунт обычно не более 3 одновременных подключений (уточняйте у администратора).
  • Трафик: лимит порядка 150 ГБ в месяц (зависит от тарифа).

Использование:

  • Не используйте VPN для незаконной деятельности, спама, распространения вредоносного ПО и запрещённого контента.
  • Используйте сервис ответственно и в соответствии с законодательством.

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

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

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

FAQ

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

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

В чём преимущества?

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

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

@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