
Tunnellisation de données via WebRTC pour contourner la censure
Fait transiter le trafic internet via des plateformes d'appels vidéo (VK Call, Yandex Telemost, WB Stream, DION, Bitrix24, Blink) afin de contourner la censure par liste blanche gouvernementale.
Guide d'installation pas à pas (en russe) : docs/SETUP.md
Deux modes de tunnel sont disponibles : DC (DataChannel) et Video (encodage de données VP8). La configuration recommandée est headless aux deux extrémités - du pur Go (Pion) dialogue directement avec le SFU de la plateforme, sans navigateur. L'obfuscation ChaCha20, le rythme VP8 configurable et le backend LiveKit/WB Stream sont des fonctionnalités réservées au mode headless.
Un chemin navigateur hérité (un joiner Android WebView face à un créateur desktop Electron avec des hooks JS) fonctionne encore pour VK DC, mais il est plus lent, ne peut pas obfusquer et est en cours d'abandon. Les nouveaux déploiements devraient utiliser le mode headless.
Pion ouvre un DataChannel SCTP sur le PC éditeur et y tunnelise TCP/UDP. Les trames traversent le SFU de la plateforme comme toute autre charge utile 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
Même pipeline que le mode DC, mais le tunnel passe par une piste vidéo VP8 publiée au lieu d'un DataChannel SCTP. Utile lorsque le SFU limite le débit des DataChannels mais laisse passer le RTP (par ex. Telemost), et obligatoire sur certaines plateformes (la piste du publisher de WB Stream est toujours de la vidéo). Le framing du tunnel et la couche de multiplexage au-dessus sont identiques au mode DC.
Le mode vidéo peut être encapsulé dans KCP (option Reliable du joiner, --reliable sur les joiners CLI) : les trames perdues sont retransmises au lieu de casser les flux TCP sur un chemin lossy. Le créateur le détecte à partir de la première trame du joiner, rien à configurer de ce côté. Pris en charge sur VK, Telemost, WB Stream, Bitrix et Blink.
Le trafic passe par le SFU de la plateforme, qui figure sur la liste blanche gouvernementale. Pour le DPI, cela ressemble à un appel vidéo normal.
relay/ - relais Go partagé par les deux extrémités : proxy SOCKS5, plomberie tun2socks, tunnel DC/VP8, obfuscateur ChaCha20, multiplexeur de connexions, bindings gomobile/iOSheadless/vk/ - Créateur VK headless : crée ou rejoint un appel via l'API HTTP de VK, tunnel Pion DC/VP8, sans navigateurheadless/telemost/ - Créateur Telemost (Yandex) headless avec le même modèleheadless/wbstream/ - Créateur WB Stream headless (basé sur LiveKit, jetons invités anonymes)headless/dion/ - Créateur DION headless avec le même modèleheadless/bitrix/ - Créateur Bitrix headless (DC/VP8 adaptatif, jointure invité)headless/blink/ - Créateur Blink headless (basé sur LiveKit, connexion via l'application Blink)headless/wbstream-joiner/ - Joiner WB Stream desktop (homologue du créateur, utilisé pour les tests et les clients Linux)headless/telemost-joiner/ - Joiner Telemost desktop (homologue du créateur, utilisé pour les tests et les clients Linux)headless/dion-joiner/ - Joiner DION desktop (homologue du créateur, utilisé pour les tests et les clients Linux)headless/bitrix-joiner/ - Joiner Bitrix desktop (homologue du créateur, utilisé pour les tests et les clients Linux)headless/blink-joiner/ - Joiner Blink desktop (homologue du créateur, utilisé pour les tests et les clients Linux)headless/vk-bot/ - Bot VK Long Poll autonome qui lance des créateurs headless à la demande et répond avec le lien de jointure (alternative côté serveur au bot Electron)headless/tests/ - Tests end-to-end en direct (créateur + joiners via un vrai SFU) ; à exécuter sur la même machine ou dans un banc netns dockerisé, voir headless/tests/README.mdandroid-app/ - Joiner Android : VpnService + tun2socks + Pion headless (chemin principal) ; conserve aussi un fallback WebView pour le flux navigateur historiqueios-proxy-app/ - Joiner iOS : SOCKS5 + Pion headless via le xcframework gomobileios-vpn-app/ - Joiner iOS avec VPN système : Network Extension + Pion headless, nécessite une équipe de signature avec la capacité Network Extensionjoiner-desktop-app/ - Joiner desktop Electron pour Windows / macOS / Linux : TUN système ou SOCKS5 uniquement, les six plateformescreator-app/ - Application créateur desktop Electron : interface graphique pouvant exécuter soit le chemin navigateur historique, soit lancer les binaires Go headless ; adaptée à la fois à l'usage interactif et aux déploiementsheadless/docker/ - Image Docker et fichier compose pour le bot VK headless avec tous les créateursdocker-build/ - Build dockerisé de l'application Android, de l'application créateur et des binaires headlesshooks/ - Hooks JavaScript pour le chemin navigateur historique (modes DC et Vidéo, VK et Telemost). Le mode headless n'utilise pas les hooks JS.Des binaires précompilés sont disponibles sur GitHub Releases.
Téléchargez et lancez l'application Electron depuis GitHub Releases. Elle embarque automatiquement les binaires Go headless.
Le mode tunnel est choisi sur le joiner, le créateur headless s'y adapte à chaque connexion. Pour exécuter les créateurs sur un serveur sans interface graphique, appuyez sur Export Cookies et utilisez les fichiers avec les binaires headless, voir docs/SETUP.md.
VK (legacy) et Telemost (legacy) utilisent l'ancien chemin navigateur. Là, l'appel doit être créé depuis l'application et le mode tunnel est choisi sur le créateur - les hooks JS doivent être présents dès le début de l'appel.
Choisissez celui qui convient à l'appareil :