
Tunneling von Daten über WebRTC zur Umgehung der Zensur
Tunnelt Internetverkehr über Videoanruf-Plattformen (VK Call, Yandex Telemost, WB Stream, DION, Bitrix24, Blink), um die Zensur durch staatliche Whitelists zu umgehen.
Schritt-für-Schritt-Einrichtungsanleitung (auf Russisch): docs/SETUP.md
Es stehen zwei Tunnelmodi zur Verfügung: DC (DataChannel) und Video (VP8-Datenkodierung). Die empfohlene Einrichtung ist headless auf beiden Seiten – reines Go (Pion) kommuniziert direkt mit dem SFU der Plattform, kein Browser. ChaCha20-Verschleierung, konfigurierbares VP8-Pacing und das LiveKit/WB Stream-Backend sind ausschließlich Headless-Funktionen.
Ein Legacy-Browserpfad (Android WebView-Joiner gegen einen Electron-Desktop-Creator mit JS-Hooks) funktioniert weiterhin für VK DC, ist aber langsamer, kann nicht verschleiern und wird auslaufen gelassen. Neue Bereitstellungen sollten Headless verwenden.
Pion öffnet einen SCTP-DataChannel auf dem Publisher-PC und tunnelt TCP/UDP darüber. Frames passieren das SFU der Plattform wie jede andere DataChannel-Nutzlast.
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
Gleiche Pipeline wie im DC-Modus, aber der Tunnel läuft über einen veröffentlichten VP8-Videotrack statt über einen SCTP-DataChannel. Nützlich, wenn die SFU DataChannels rate-limitiert, aber RTP durchlässt (z. B. Telemost), und in manchen Fällen von der Plattform vorgeschrieben (der Publisher-Track von WB Stream ist immer Video). Tunnel-Framing und die darüberliegende Multiplex-Schicht sind dieselben wie im DC-Modus.
Der Video-Modus kann in KCP eingebettet werden (die Option Reliable des Joiners, --reliable bei den CLI-Joinern): Verlorene Frames werden erneut übertragen, statt TCP-Streams auf einem verlustbehafteten Pfad abzubrechen. Der Ersteller erkennt dies am ersten Frame des Joiners, auf dieser Seite ist nichts zu konfigurieren. Unterstützt auf VK, Telemost, WB Stream, Bitrix und Blink.
Der Datenverkehr läuft über die SFU der Plattform, die auf der Whitelist der Regierung steht. Für DPI sieht es wie ein normaler Videoanruf aus.
relay/ - Go-Relay, das von beiden Enden gemeinsam genutzt wird: SOCKS5-Proxy, tun2socks-Anbindung, DC/VP8-Tunnel, ChaCha20-Obfuskator, Verbindungs-Multiplexer, gomobile/iOS-Bindingsheadless/vk/ - Headless-VK-Ersteller: erstellt oder tritt einem Anruf über die VK-HTTP-API bei, Pion-DC/VP8-Tunnel, kein Browserheadless/telemost/ - Headless-Telemost-Ersteller (Yandex) mit demselben Modellheadless/wbstream/ - Headless-WB-Stream-Ersteller (LiveKit-basiert, anonyme Gast-Tokens)headless/dion/ - Headless-DION-Ersteller mit demselben Modellheadless/bitrix/ - Headless-Bitrix-Ersteller (adaptives DC/VP8, Gast-Beitritt)headless/blink/ - Headless-Blink-Ersteller (LiveKit-basiert, meldet sich über die Blink-App an)headless/wbstream-joiner/ - Desktop-WB-Stream-Joiner (Gegenstück zum Ersteller, verwendet für Tests und Linux-Clients)headless/telemost-joiner/ - Desktop-Telemost-Joiner (Gegenstück zum Ersteller, verwendet für Tests und Linux-Clients)headless/dion-joiner/ - Desktop-DION-Joiner (Gegenstück zum Ersteller, verwendet für Tests und Linux-Clients)headless/bitrix-joiner/ - Desktop-Bitrix-Joiner (Gegenstück zum Ersteller, verwendet für Tests und Linux-Clients)headless/blink-joiner/ - Desktop-Blink-Joiner (Gegenstück zum Ersteller, verwendet für Tests und Linux-Clients)headless/vk-bot/ - Eigenständiger VK-Long-Poll-Bot, der bei Bedarf Headless-Ersteller startet und mit dem Beitrittslink antwortet (serverseitige Alternative zum Electron-Bot)headless/tests/ - Live-End-to-End-Tests (Ersteller + Joiner über eine echte SFU); Ausführung auf demselben Host oder in einem dockerisierten netns-Aufbau, siehe headless/tests/README.mdandroid-app/ - Android-Joiner: VpnService + tun2socks + Headless-Pion (primärer Pfad); behält außerdem einen WebView-Fallback für den Legacy-Browser-Flow beiios-proxy-app/ - iOS-Joiner: SOCKS5 + Headless-Pion über das gomobile-xcframeworkios-vpn-app/ - iOS-Joiner mit System-VPN: Network Extension + Headless-Pion, benötigt ein Signing-Team mit der Network-Extension-Fähigkeitjoiner-desktop-app/ - Electron-Desktop-Joiner für Windows / macOS / Linux: nur System-TUN oder SOCKS5, alle sechs Plattformencreator-app/ - Electron-Desktop-Ersteller-App: GUI-Frontend, das entweder den Legacy-Browser-Pfad ausführen oder die Headless-Go-Binaries starten kann; geeignet sowohl für interaktive Nutzung als auch für Deploymentsheadless/docker/ - Docker-Image und Compose-Datei für den Headless-VK-Bot mit allen Erstellerndocker-build/ - Dockerisierter Build der Android-App, der Ersteller-App und der Headless-Binarieshooks/ - JavaScript-Hooks für den Legacy-Browser-Pfad (DC- und Video-Modus, VK und Telemost). Headless verwendet keine JS-Hooks.Vorgefertigte Binaries sind auf GitHub Releases verfügbar.
Lade die Electron-App von GitHub Releases herunter und führe sie aus. Sie bündelt die Headless-Go-Binaries automatisch.
Der Tunnelmodus wird am Joiner gewählt, der headless Creator passt sich bei jeder Verbindung daran an. Um die Creator auf einem Server ohne GUI auszuführen, klicke auf Export Cookies und verwende die Dateien mit den headless Binaries, siehe docs/SETUP.md.
VK (legacy) und Telemost (legacy) verwenden den alten Browser-Pfad. Dort muss der Anruf aus der App heraus erstellt werden und der Tunnelmodus wird am Creator gewählt – die JS-Hooks müssen ab dem Moment vorhanden sein, in dem der Anruf startet.
Wähle, was zum Gerät passt: