YPtun

Большинство VPN-клиентов дают одно ядро и один способ подключения. YPtun даёт набор инструментов. В одном приложении сразу несколько движков обхода: заблокировали один способ — переключился и работаешь дальше.

Главное — универсальность. Xray и sing-box со всеми ходовыми протоколами и транспортами, обфусцированный WireGuard через AmneziaWG, туннелирование через реальные звонки (VK-TURN и olcRTC), DNS-туннель MasterDNS, импорт чего угодно и Happ-совместимые профили маршрутизации. Один способ зарезали — рядом ещё несколько.

Сделано для мест, где интернет сопротивляется — для России, Ирана и любой страны, где сайты пропадают без предупреждения.

Теперь и на Windows — установщик и портативная версия одним .exe, x64 и нативный ARM64. То же приложение и те же движки, что на телефоне: подписки, профили маршрутизации, каскад, VK-TURN, olcRTC, MasterDNS, Trust Tunnel.

Клиент для iOS — полноценное нативное приложение для iPhone и iPad с глубокой интеграцией в систему: Dynamic Island, Live Activity на экране блокировки, виджет быстрого переключения в Пункте управления (iOS 18+), поддержка быстрых команд Siri Shortcuts и автоматическое переподключение.

Бери последний подписанный APK со страницы релизов.

Минимум — Android 6.0 (API 23).

Бета-версия для iPhone и iPad доступна в Apple TestFlight. Ссылка на подключение опубликована в нашем Telegram-канале @YPtun в топике Download.

• Минимальная версия: iOS 16.0+ / iPadOS 16.0+
• Возможности: туннелирование всех приложений через NetworkExtension, Dynamic Island и Live Activity, виджет Пункта управления (iOS 18+), автоматизация через Команды (Siri Shortcuts).
• Поддерживаемые протоколы: VLESS (Reality, WS, gRPC, TCP), VMess, Trojan, Shadowsocks, Hysteria2, WireGuard / AmneziaWG.

YPtun запрашивает только то, без чего не работает конкретная функция. Камеру, уведомления, работу без ограничений батареи и установку обновлений приложение спрашивает в тот момент, когда вы пользуетесь этой функцией, а не при установке.

• GitHub — проверка обновлений и, по умолчанию, списки для маршрутизации (geoip/geosite, ASN).
• check.happ-proxy.com — только если в подписке есть Happ providerid: раз в сутки, как и Happ, приложение отправляет туда отметку с теми же данными устройства, что получает сама подписка (HWID, ОС, модель, версия приложения). Без providerid этого запроса нет.
• Сервисы выбранного способа подключения — VK (VK-TURN), Cloudflare (Telegram через WARP), сервисы звонков (olcRTC), Яндекс Документы или MAX (OpenFlux).

┌──────────────┐   пакеты   ┌───────────────┐   SOCKS5   ┌────────────────────────────┐
│  Приложения  │ ─────────▶ │  Android TUN  │ ─────────▶ │     Движок (1 процесс)     │
└──────────────┘            │  (IPv4+IPv6)  │            │  ┌──────────────────────┐  │
                            └───────────────┘            │  │  Xray / sing-box     │  │
                                                         │  │  AmneziaWG / VK-TURN │  │
                                                         │  │  MasterDNS / стелс olcRTC│  │
                                                         │  └──────────────────────┘  │
                                                         └─────────────┬──────────────┘
                                                                       ▼
                                                                открытый интернет

Все нативные ядра собраны в одну gomobile-библиотеку (единый Go-рантайм), поэтому Xray, sing-box, AmneziaWG, VK-TURN, MasterDNS и olcRTC уживаются в одном процессе без конфликтов. Приложение поднимает VpnService, отдаёт пакеты в TUN и заворачивает их в выбранный движок через локальный SOCKS5.

• Xray / sing-box — классические прокси-ядра: VLESS+Reality, XHTTP, WS+TLS и т.д. Ядро выбирается под транспорт автоматически.
• AmneziaWG — WireGuard с обфускацией: рукопожатие и пакеты не похожи на «обычный» WireGuard, который часто режут по сигнатуре.
• Hysteria2 — быстрый протокол поверх QUIC с обфускацией Salamander и перескоком портов; хорошо держит скорость на нестабильных каналах.
• VK-TURN — поднимает локальный WireGuard и гонит его через TURN-серверы звонков VK; несколько «звонков» связываются для пропускной способности.
• MasterDNS — туннель поверх DNS-запросов; работает там, где открыт только DNS.
• olcRTC — маскировка под видеозвонок: трафик едет через настоящие сервисы конференций, и для DPI выглядит как живой созвон.
• Telegram-прокси через WARP — отдельный фоновый прокси для Telegram поверх Cloudflare WARP.

Всё необходимое уже в репозитории (cores, olcrtc, sing-box, awgproxy, hysteria2proxy, free-turn-proxy, masterdns, wdtt, amneziawg-go). Понадобится:

• JDK 17 (подойдёт встроенный в Android Studio)
• Android SDK (укажи sdk.dir в YPtun/local.properties) + NDK 28.2.13676358
• Go + gomobile в PATH

gomobile вызывает javac, поэтому добавь bin/ из JDK в PATH — не только JAVA_HOME.

cd YPtun
./gradlew :androidApp:assembleRelease \
  -Polcbox.version=3.6.0 -Polcbox.versionCode=381

APK появятся в YPtun/androidApp/build/outputs/apk/release/. Хочешь только под свой телефон и быстрее — добавь -Polcbox.android.abiFilters=arm64-v8a.

Десктопная сборка (Windows, нужен Go в PATH, Android SDK всё равно требуется — Gradle конфигурирует общие модули):

cd YPtun
./gradlew :desktopApp:createDistributable          # готовый образ приложения
powershell -File desktopApp/packaging/windows/build-installer.ps1   # установщик
powershell -File desktopApp/packaging/windows/build-portable.ps1    # портативный .exe

Сборка для iOS (macOS, Xcode 15+, Go):

cd YPtun
# Сборка общего Kotlin Multiplatform фреймворка:
./gradlew :sharedUI:embedAndSignAppleFrameworkForXcode
# Генерация проекта Xcode (если используется XcodeGen):
cd iosApp && xcodegen generate
# Открытие проекта в Xcode:
open iosApp.xcodeproj

storeFile=release.keystore
storePassword=твой-пароль
keyAlias=твой-алиас
keyPassword=твой-пароль

YPtun — Kotlin Multiplatform: вся логика (импорт, сборка конфигов, движки, состояние UI) живёт в commonMain, платформенные мелочи — в androidMain. Тот же код крутится и на JVM-десктопе.

• UI — Jetpack Compose, единый дизайн на всех платформах.
• Локализация — русский, английский, فارسی и 简体中文 в одном файле строк.
• Native-ядра — Go, собираются в один gomobile-AAR таском buildCoresAndroidAar; входы ядер отслеживаются, AAR пересобирается только при правке Go-кода.
• Тесты — модульные тесты на парсеры/конвертеры маршрутизации (./gradlew :sharedUI:jvmTest).
• Ветки — стабильное в main, активная разработка в Beta, десктопная — в pc-client-beta; релизы тегируются vX.Y.Z.

Нашёл баг или хочешь фичу — открывай issue или PR, см. CONTRIBUTING.md.

YPtun/            Kotlin Multiplatform приложение — Compose UI, Android VpnService, движки
YPtun/iosApp/     iOS клиент — SwiftUI, PacketTunnelProvider (NetworkExtension), Live Activity, Widgets
cores/            Go-связка: один gomobile-AAR из sing-box + olcRTC + Xray + AmneziaWG + VK-TURN + MasterDNS
olcrtc/           olcRTC — транспорт-маскировка под видеозвонок   (сторонний, вендорено)
sing-box/         sing-box / libbox                                (вендорено)
awgproxy/         обёртка AmneziaWG → локальный SOCKS5             (Go-модуль)
hysteria2proxy/   обёртка Hysteria2 (apernet) → локальный SOCKS5   (Go-модуль)
free-turn-proxy/  VK-TURN — туннель через звонки VK                (Go-модуль)
masterdns/        MasterDNS — туннель поверх DNS                    (клиент + сервер)
wdtt/             WDTT — вариант туннеля                           (клиент + сервер)
amneziawg-go/     реализация AmneziaWG                             (вендорено)

• Релиз на Android
• Движки AmneziaWG, VK-TURN и MasterDNS
• Профили маршрутизации (Happ-совместимые) + ASN
• Сборка под Windows (x64 и ARM64)
• Сборка под Linux (.deb, x64 и ARM64)
• Сборка под iOS — в бете

PR и issue приветствуются. Перед началом загляни в:

• CONTRIBUTING.md — как собрать, оформить и прислать изменения
• CODE_OF_CONDUCT.md — правила общения
• SECURITY.md — как сообщить об уязвимости

На плечах гигантов: Xray-core · sing-box · olcRTC · AmneziaWG · OpenFlux · qWDTT · MasterDnsVPN · free-turn-proxy · TrustTunnel · hev-socks5-tunnel · tun2socks.

Бесплатная подпись кода — SignPath.io, сертификат — SignPath Foundation. Подписываются Windows-установщик и portable, собранные в GitHub Actions из этого репозитория.

• Коммиттеры и ревьюеры: участники репозитория
• Утверждение подписи: владелец репозитория

Конфиденциальность: приложение само не передаёт данные в другие сетевые системы, кроме тех, что выбрал пользователь (его серверы, подписки, выбранные им сервисы обхода), и проверки обновлений на GitHub. Подробности — в разделе «Разрешения и зачем они нужны».

GPL-3.0 — приложение распространяется под GNU GPL v3.0, так как включает sing-box (тоже GPL-3.0): копилефт распространяется на весь продукт. Вендоренные компоненты сохраняют свои лицензии (sing-box — GPL-3.0, Xray — MPL-2.0, amneziawg-go — MIT, olcrtc — WTFPL, OpenFlux — GPL-3.0, qWDTT (wdtt) — GPL-3.0, MasterDnsVPN (masterdns) — MIT, free-turn-proxy — Happy Bunny License (MIT-подобная), Trust Tunnel — Apache-2.0, hev-socks5-tunnel — MIT, tun2socks — MIT).

«Нация, которая боится позволить своему народу судить о правде и лжи на открытом рынке, — это нация, которая боится своего народа.»

— Джон Ф. Кеннеди

_{Для свободного интернета}