
Туннелирование данных через WebRTC для обхода цензуры
Туннелирует интернет-трафик через платформы видеозвонков (VK Call, Yandex Telemost, WB Stream, DION, Bitrix24, Blink) для обхода государственной цензуры белых списков.
Пошаговое руководство по установке (на русском): docs/SETUP.md
Доступны два режима туннеля: DC (DataChannel) и Video (кодирование данных VP8). Рекомендуемая конфигурация — headless с обеих сторон — чистый Go (Pion) напрямую взаимодействует с SFU платформы, без браузера. Обфускация ChaCha20, настраиваемый пейсинг VP8 и бэкенд LiveKit/WB Stream — это функции, доступные только в headless-режиме.
Устаревший браузерный путь (Android WebView-джойнер против десктопного создателя на Electron с JS-хуками) всё ещё работает для VK DC, но он медленнее, не поддерживает обфускацию и постепенно выводится из эксплуатации. Новые развёртывания должны использовать headless.
Pion открывает SCTP DataChannel на издательском PC и туннелирует через него TCP/UDP. Кадры проходят через SFU платформы, как и любая другая полезная нагрузка DataChannel.
Joiner (censored, Android/iOS/desktop) Creator (free internet)
All apps
|
VpnService (captures all traffic)
|
tun2socks (IP -> TCP)
|
SOCKS5 proxy (Go, :1080)
|
Headless joiner (Pion) Headless creator (Pion)
| |
DataChannel <------- SFU -------> DataChannel
|
Relay bridge
|
Internet
Тот же конвейер, что и в режиме DC, но туннель работает поверх опубликованного видеотрека VP8 вместо SCTP DataChannel. Полезно, когда SFU ограничивает скорость DataChannel, но пропускает RTP (например, Telemost), а в некоторых случаях обязателен на уровне платформы (трек публикатора WB Stream всегда является видео). Кадрирование туннеля и мультиплексный слой над ним такие же, как в режиме DC.
Видеорежим можно обернуть в KCP (опция Reliable у присоединяющегося, --reliable в CLI-присоединяющихся): потерянные кадры передаются повторно вместо разрыва TCP-потоков на пути с потерями. Создатель определяет это по первому кадру присоединяющегося, на его стороне настраивать ничего не нужно. Поддерживается на VK, Telemost, WB Stream, Bitrix и Blink.
Трафик проходит через SFU платформы, который находится в правительственном белом списке. Для DPI это выглядит как обычный видеозвонок.
relay/ - Go-релей, общий для обоих концов: прокси SOCKS5, обвязка tun2socks, туннель DC/VP8, обфускатор ChaCha20, мультиплексор соединений, привязки gomobile/iOSheadless/vk/ - Headless-создатель VK: создаёт или присоединяется к звонку через HTTP API VK, туннель Pion DC/VP8, без браузераheadless/telemost/ - Headless-создатель Telemost (Yandex) с той же модельюheadless/wbstream/ - Headless-создатель WB Stream (на базе LiveKit, анонимные гостевые токены)headless/dion/ - Headless-создатель DION с той же модельюheadless/bitrix/ - Headless-создатель Bitrix (адаптивный DC/VP8, гостевое присоединение)headless/blink/ - Headless-создатель Blink (на базе LiveKit, вход через приложение Blink)headless/wbstream-joiner/ - Настольный присоединяющийся WB Stream (аналог создателя, используется для тестов и Linux-клиентов)headless/telemost-joiner/ - Настольный присоединяющийся Telemost (аналог создателя, используется для тестов и Linux-клиентов)headless/dion-joiner/ - Настольный присоединяющийся DION (аналог создателя, используется для тестов и Linux-клиентов)headless/bitrix-joiner/ - Настольный присоединяющийся Bitrix (аналог создателя, используется для тестов и Linux-клиентов)headless/blink-joiner/ - Настольный присоединяющийся Blink (аналог создателя, используется для тестов и Linux-клиентов)headless/vk-bot/ - Автономный бот VK Long Poll, который по запросу запускает headless-создателей и отвечает ссылкой для присоединения (серверная альтернатива боту Electron)headless/tests/ - Живые сквозные тесты (создатель + присоединяющиеся через реальный SFU); запускайте на том же хосте или в докеризованном стенде netns, см. headless/tests/README.mdandroid-app/ - Android-присоединяющийся: VpnService + tun2socks + headless Pion (основной путь); также сохраняет запасной вариант WebView для устаревшего браузерного потокаios-proxy-app/ - iOS-присоединяющийся: SOCKS5 + headless Pion через xcframework gomobileios-vpn-app/ - iOS-присоединяющийся с системным VPN: Network Extension + headless Pion, требуется команда подписи с возможностью Network Extensionjoiner-desktop-app/ - Настольный присоединяющийся Electron для Windows / macOS / Linux: только системный TUN или SOCKS5, все шесть платформcreator-app/ - Настольное приложение-создатель Electron: графический интерфейс, который может запускать либо устаревший браузерный путь, либо порождать headless-бинарники Go; подходит как для интерактивного использования, так и для развёртыванийheadless/docker/ - Образ Docker и compose-файл для headless-бота VK со всеми создателямиdocker-build/ - Докеризованная сборка Android-приложения, приложения-создателя и headless-бинарниковhooks/ - Хуки JavaScript для устаревшего браузерного пути (режимы DC и Video, VK и Telemost). Headless не использует хуки JS.Готовые бинарники доступны на GitHub Releases.
Скачайте и запустите приложение Electron с GitHub Releases. Оно автоматически включает headless-бинарники Go.
Режим туннеля выбирается на стороне присоединяющегося, а headless-создатель подстраивается под него при каждом подключении. Чтобы запускать создателей на сервере без графического интерфейса, нажмите Export Cookies и используйте файлы с headless-бинарниками, см. docs/SETUP.md.
VK (legacy) и Telemost (legacy) работают по старому браузерному пути. Там звонок должен быть создан изнутри приложения, а режим туннеля выбирается на стороне создателя — JS-хуки должны присутствовать с момента начала звонка.
Выберите то, что подходит устройству: