WINGS-N/WINGSV
1
0
Fork 0
mirror of https://github.com/WINGS-N/WINGSV.git synced 2026-07-14 20:26:27 +00:00
Code Issues Projects Packages Wiki Activity
VPN клиент под Xray и vk-turn-proxy с дизайном Samsung One UI, root раздачей VPN, bypass'ом приложений, встроенным WG (+ root mode), ByeDPI, автопереключением, Xposed модулем для скрытия VPN, и многим другим
523 commits 3 branches 30 tags 8.7 MiB
  • Java 96.6%
  • C++ 1.9%
  • Kotlin 0.9%
  • Python 0.3%
  • Shell 0.1%
Find a file
Exact
Nikita b27dde4c43 [app/test] assert the bypass captcha default survives a profile proto round-trip
2026-07-14 21:36:41 +03:00
.github [ci]: install cargo-ndk for the upstream-runtime daemon build 2026-06-22 12:19:02 +03:00
app [app/test] assert the bypass captcha default survives a profile proto round-trip 2026-07-14 21:36:41 +03:00
config [app/lint]: enable Unused*/LiteralsFirstInComparisons/CompareObjectsWithEquals PMD rules and clean dead code 2026-06-20 02:40:25 +03:00
external [external/vk-turn-proxy] bump 2026-07-14 20:50:05 +03:00
gradle [app/ipc] add AppControl grpc client over a local unix socket, with grpc-java codegen 2026-07-03 08:53:54 +03:00
readme-res/screenshots Initial commit 2026-04-02 05:49:19 +03:00
scripts [scripts]: add mock app-updates server for debug testing 2026-04-26 16:46:27 +03:00
vpnhotspot [vpnhotspot]: bump bridge + sharing-bridge compileSdk to 37 and wire copyMobileSources into Gradle 9 strict task graph 2026-06-21 00:51:16 +03:00
.gitignore [ignore]: update gitignore 2026-04-23 02:18:50 +03:00
.gitmodules [external/VPNHotspot]: bump to main with synthetic root WG + DNS fallback 2026-06-20 01:54:08 +03:00
.prettierignore [build]: add Java linting and native build integration 2026-04-08 07:51:11 +03:00
AGENTS.md [docs] add AGENTS.md 2026-06-30 01:28:25 +03:00
build.gradle.kts [bridge]: bump VPNHotspot to v3.0.4 daemon arch + sharing runtime port 2026-06-19 15:16:29 +03:00
CLAUDE.md [docs] add AGENTS.md 2026-06-30 01:28:25 +03:00
gradle.properties [app/build]: drop redundant uses-sdk + suppress compileSdk 37 warning 2026-06-19 16:38:06 +03:00
gradlew Initial commit 2026-04-02 05:49:19 +03:00
gradlew.bat Initial commit 2026-04-02 05:49:19 +03:00
keystore.properties.example Initial commit 2026-04-02 05:49:19 +03:00
LICENSE LICENSE: init 2026-04-02 23:40:51 +03:00
package.json [build]: bump pnpm 2026-04-16 14:50:12 +03:00
pnpm-lock.yaml [build]: add Java linting and native build integration 2026-04-08 07:51:11 +03:00
prettier.config.cjs [build]: add Java linting and native build integration 2026-04-08 07:51:11 +03:00
README.md [docs] correct the wingsv:// link format (0x12 frame, url-safe base64, zlib) 2026-07-06 16:20:08 +03:00
settings.gradle.kts [build]: group vpnhotspot bridge/runtime modules under vpnhotspot/ 2026-06-19 03:55:50 +03:00

README.md

WINGS V

Telegram Чат

Клиент Xray, vk-turn-proxy, WireGuard, AmneziaWG в интерфейсе Samsung One UI

Скриншоты
Главная Роутинг приложений
VPN Hotspot Настройки

Что умеет

  • работать через Xray (VLESS), VK TURN + WireGuard или AmneziaWG, обычные WireGuard/AmneziaWG
  • показывать статус подключения, IP, страну, провайдера и сетевую статистику
  • работать в обычном VPN режиме через VpnService
  • работать в root режиме для VK TURN + WireGuard
  • настраивать маршрутизацию по приложениям
  • раздавать VPN через Wi‑Fi, USB, Bluetooth и Ethernet
  • показывать отдельные логи vk-turn-proxy, Xray и runtime приложения
  • импортировать и экспортировать конфигурации через wingsv://
  • импортировать vless:// и raw awg-quick конфиги
  • работать с Xray профилями и подписками
  • переключаться через launcher actions, внешние intents и Quick Settings tiles

Панель 3x-ui с встроенным vk-turn-proxy

В качестве сервера, вы можете использовать эту панель 3x-ui, в которой уже вшит vk-turn-proxy как inbound

WINGS V VKTP (форк vk-turn-proxy)

Для наилучшего результата на серверной стороне используйте форк WINGS V VKTP. В нём есть WRAP SRTP-mimicry обфускация и in-band доставка ключа, которые клиент WINGS V включает по умолчанию для обхода content-фильтрации VK. Панель 3x-ui выше собирается с этим же форком.

wingsv:// ссылки

  • Формат: wingsv://{base64url(0x12 || zlib(protobuf Config))} - URL-safe base64 (с паддингом, без переносов) от кадра: байт формата 0x12, затем zlib-сжатый (с zlib-заголовком) protobuf-message Config (wingsv.proto). См. WingsImportParser.encodeConfig / decodePayload.
  • Внутри могут храниться:
    • VK TURN + WireGuard настройки
    • Xray профили и подписки
    • VK TURN + AmneziaWG конфиг

Что используется

  • Java для основного приложения
  • OneUI / SESL 8 для интерфейса
  • com.wireguard.android:tunnel для WireGuard
  • external/vk-turn-proxy для native VK TURN клиента
  • external/libXray + external/Xray-core для Xray
  • external/amneziawg-android для VK TURN + AmneziaWG
  • external/VPNHotspot для root раздачи

Сборка

Нужно задать credentials для SESL GitHub Packages вне репозитория:

  • seslUser
  • seslToken
# Сразу склонить с submodules
git clone --recurse-submodules https://github.com/WINGS-N/WINGSV.git

# Или после простого clone
# Инициализация submodules
git submodule update --init --recursive

Локальная сборка:

# debug сборка
./gradlew :app:assembleDebug

# релизная сборка
./gradlew :app:assembleRelease

Для локальной сборки также нужны:

  • Android SDK
  • Android NDK
  • protoc
  • go
  • gomobile

Release

GitHub Actions собирают:

  • CI debug build на main
  • release APK по тегам v*

Special thanks to