FreeTurn — Android TURN Proxy

Android-клиент для vk-turn-proxy — проброс WireGuard/Hysteria-трафика через TURN-серверы.

Disclaimer: Проект предназначен исключительно для образовательных и исследовательских целей.

Принцип работы

Пакеты шифруются DTLS 1.2 и отправляются на TURN-сервер по протоколу STUN ChannelData (TCP или UDP). TURN-сервер пересылает трафик по UDP на ваш VPS, где он расшифровывается и передаётся в WireGuard/Hysteria. Учётные данные для TURN генерируются автоматически из ссылки на звонок.

Возможности

• GUI и Raw режимы — удобная форма с полями или ввод аргументов вручную
• Управление сервером по SSH — установка, запуск, остановка и мониторинг серверной части прямо из приложения (пароль или SSH-ключ)
• Капча — автоматическое обнаружение и решение
• Watchdog — автоматический перезапуск при обрыве (до 8 попыток, экспоненциальный backoff)
• Смена сети — детектирование переключения Wi-Fi/Mobile и автоматическое переподключение
• Кастомное ядро — возможность загрузить свой бинарник вместо встроенного
• Шифрование секретов — SSH-пароли и ключи хранятся в EncryptedSharedPreferences (AES-256-GCM, Android Keystore)
• TOFU — верификация SSH-хостов по отпечатку (Trust On First Use)
• Broadcast API — управление прокси через intent (START_PROXY / STOP_PROXY) для автоматизации

Скриншоты

Требования

• Android 6.0+ (API 23)
• ARM64-устройство (arm64-v8a)
• VPS с установленным WireGuard или Hysteria
• Ссылка на звонок

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

1. Серверная часть

Установите и запустите серверную часть на VPS:

# Скачать бинарник
wget https://github.com/cacggghp/vk-turn-proxy/releases/latest/download/server-linux-amd64

# Запустить
chmod +x server-linux-amd64
nohup ./server-linux-amd64 -listen 0.0.0.0:56000 -connect 127.0.0.1:<порт_wg> > server.log 2>&1 &

Или используйте встроенный SSH-менеджер в приложении — он скачает, установит и запустит серверную часть за вас.

2. Android-клиент

1. Установите APK из Releases
2. Пройдите онбординг или пропустите его
3. Заполните настройки:
   • Адрес сервера — IP:порт вашего VPS (например 1.2.3.4:56000)
   • Ссылка — ссылка на звонок
   • Локальный адрес — по умолчанию 127.0.0.1:9000
4. Нажмите кнопку запуска. При успехе в логах появится Established DTLS connection!

Стек

• Kotlin + Jetpack Compose + Material 3
• Coroutines / StateFlow — реактивная архитектура
• JSch — SSH-клиент
• EncryptedSharedPreferences — шифрование секретов
• DataStore — хранение настроек
• Нативный бинарник на Go — libvkturn.so (arm64-v8a)

Благодарности

• alexmac6574/vk-turn-proxy — @alexmac6574, форк ядро vk-turn-proxy
• cacggghp/vk-turn-proxy — @cacggghp, оригинальное vk-turn-proxy
• MYSOREZ/vk-turn-proxy-android — @MYSOREZ, оригинальный Android-клиент

Лицензия

GPL-3.0