
Tunneling di dati su webrtc per aggirare la censura
Instrada il traffico internet attraverso piattaforme di videochiamata (VK Call, Yandex Telemost, WB Stream, DION, Bitrix24, Blink) per aggirare la censura basata sulle whitelist governative.
Guida alla configurazione passo passo (in russo): docs/SETUP.md
Sono disponibili due modalità di tunnel: DC (DataChannel) e Video (codifica dati VP8). La configurazione consigliata è headless su entrambe le estremità - Go puro (Pion) comunica direttamente con l'SFU della piattaforma, senza browser. L'offuscamento ChaCha20, il pacing VP8 configurabile e il backend LiveKit/WB Stream sono funzionalità esclusive della modalità headless.
Un percorso legacy basato su browser (joiner Android WebView contro un creator desktop Electron con hook JS) funziona ancora per VK DC, ma è più lento, non può offuscare ed è in fase di dismissione. Le nuove distribuzioni dovrebbero usare la modalità headless.
Pion apre un DataChannel SCTP sul PC publisher e vi incanala TCP/UDP. I frame passano attraverso l'SFU della piattaforma come qualsiasi altro payload 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
Stessa pipeline della modalità DC, ma il tunnel viaggia su una traccia video VP8 pubblicata invece che su un DataChannel SCTP. Utile quando l'SFU limita la velocità dei DataChannel ma lascia passare RTP (ad es. Telemost), e obbligatorio a livello di piattaforma in alcuni casi (la traccia publisher di WB Stream è sempre video). Il framing del tunnel e il livello di multiplexing sopra di esso sono gli stessi della modalità DC.
La modalità video può essere incapsulata in KCP (l'opzione Reliable del joiner, --reliable sui joiner CLI): i frame persi vengono ritrasmessi invece di interrompere i flussi TCP su un percorso con perdite. Il creator lo rileva dal primo frame del joiner, nulla da configurare da quel lato. Supportato su VK, Telemost, WB Stream, Bitrix e Blink.
Il traffico passa attraverso l'SFU della piattaforma, che è nella whitelist governativa. Per il DPI sembra una normale videochiamata.
relay/ - Relay Go condiviso da entrambe le estremità: proxy SOCKS5, plumbing tun2socks, tunnel DC/VP8, offuscatore ChaCha20, multiplexer di connessioni, binding gomobile/iOSheadless/vk/ - Creator VK headless: crea o si unisce a una chiamata tramite l'API HTTP di VK, tunnel Pion DC/VP8, senza browserheadless/telemost/ - Creator Telemost (Yandex) headless con lo stesso modelloheadless/wbstream/ - Creator WB Stream headless (basato su LiveKit, token guest anonimi)headless/dion/ - Creator DION headless con lo stesso modelloheadless/bitrix/ - Creator Bitrix headless (DC/VP8 adattivo, join come guest)headless/blink/ - Creator Blink headless (basato su LiveKit, accede tramite l'app Blink)headless/wbstream-joiner/ - Joiner WB Stream desktop (controparte del creator, usato per test e client Linux)headless/telemost-joiner/ - Joiner Telemost desktop (controparte del creator, usato per test e client Linux)headless/dion-joiner/ - Joiner DION desktop (controparte del creator, usato per test e client Linux)headless/bitrix-joiner/ - Joiner Bitrix desktop (controparte del creator, usato per test e client Linux)headless/blink-joiner/ - Joiner Blink desktop (controparte del creator, usato per test e client Linux)headless/vk-bot/ - Bot VK Long Poll autonomo che avvia creator headless su richiesta e risponde con il link di join (alternativa lato server al bot Electron)headless/tests/ - Test end-to-end live (creator + joiner su un SFU reale); eseguire sullo stesso host o in un stand netns dockerizzato, vedi headless/tests/README.mdandroid-app/ - Joiner Android: VpnService + tun2socks + Pion headless (percorso principale); mantiene anche un fallback WebView per il flusso browser legacyios-proxy-app/ - Joiner iOS: SOCKS5 + Pion headless tramite l'xcframework gomobileios-vpn-app/ - Joiner iOS con VPN di sistema: Network Extension + Pion headless, richiede un team di firma con la capability Network Extensionjoiner-desktop-app/ - Joiner desktop Electron per Windows / macOS / Linux: solo TUN di sistema o SOCKS5, tutte e sei le piattaformecreator-app/ - App creator desktop Electron: front-end GUI che può eseguire il percorso browser legacy o avviare i binari Go headless; adatta sia all'uso interattivo che ai deploymentheadless/docker/ - Immagine Docker e file compose per il bot VK headless con tutti i creatordocker-build/ - Build dockerizzata dell'app Android, dell'app creator e dei binari headlesshooks/ - Hook JavaScript per il percorso browser legacy (modalità DC e Video, VK e Telemost). Headless non usa hook JS.I binari precompilati sono disponibili su GitHub Releases.
Scarica ed esegui l'app Electron da GitHub Releases. Include automaticamente i binari Go headless.
La modalità tunnel viene scelta sul joiner, il creator headless vi si adatta a ogni connessione. Per eseguire i creator su un server senza GUI, premi Export Cookies e usa i file con i binari headless, vedi docs/SETUP.md.
VK (legacy) e Telemost (legacy) usano il vecchio percorso del browser. Lì la chiamata deve essere creata dall'interno dell'app e la modalità tunnel viene scelta sul creator - gli hook JS devono essere presenti dal momento in cui la chiamata inizia.
Scegli quello che si adatta al dispositivo: