
Tunneling data over webrtc to bypass censorship
Tunnels internet traffic through video calling platforms (VK Call, Yandex Telemost, WB Stream, DION, Bitrix24, Blink) to bypass government whitelist censorship.
Step-by-step setup guide (in Russian): docs/SETUP.md
Two tunnel modes are available: DC (DataChannel) and Video (VP8 data encoding). The recommended setup is headless on both ends - pure Go (Pion) talks to the platform's SFU directly, no browser. ChaCha20 obfuscation, configurable VP8 pacing, and the LiveKit/WB Stream backend are headless-only features.
A legacy browser path (Android WebView joiner against an Electron desktop creator with JS hooks) still works for VK DC, but it's slower, can't obfuscate, and is being phased out. New deployments should use headless.
Pion opens a SCTP DataChannel on the publisher PC and tunnels TCP/UDP through it. Frames pass through the platform's SFU like any other DataChannel payload.
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
Same pipeline as DC mode, but the tunnel rides on a published VP8 video track instead of a SCTP DataChannel. Useful when the SFU rate-limits DataChannels but lets RTP through (e.g. Telemost), and platform-mandatory in some cases (WB Stream's publisher track is always video). Tunnel framing and the multiplex layer above it are the same as DC mode.
Video mode can be wrapped in KCP (the joiner's Reliable option, --reliable on the CLI joiners): lost frames are retransmitted instead of breaking TCP streams on a lossy path. The creator detects it from the joiner's first frame, nothing to configure on that side. Supported on VK, Telemost, WB Stream, Bitrix and Blink.
Traffic goes through the platform's SFU, which is on the government whitelist. To DPI it looks like a normal video call.
relay/ - Go relay shared by both ends: SOCKS5 proxy, tun2socks plumbing, DC/VP8 tunnel, ChaCha20 obfuscator, connection multiplexer, gomobile/iOS bindingsheadless/vk/ - Headless VK creator: creates or joins a call via the VK HTTP API, Pion DC/VP8 tunnel, no browserheadless/telemost/ - Headless Telemost (Yandex) creator with the same modelheadless/wbstream/ - Headless WB Stream creator (LiveKit-backed, anonymous guest tokens)headless/dion/ - Headless DION creator with the same modelheadless/bitrix/ - Headless Bitrix creator (adaptive DC/VP8, guest join)headless/blink/ - Headless Blink creator (LiveKit-backed, logs in through the Blink app)headless/wbstream-joiner/ - Desktop WB Stream joiner (counterpart to the creator, used for tests and Linux clients)headless/telemost-joiner/ - Desktop Telemost joiner (counterpart to the creator, used for tests and Linux clients)headless/dion-joiner/ - Desktop DION joiner (counterpart to the creator, used for tests and Linux clients)headless/bitrix-joiner/ - Desktop Bitrix joiner (counterpart to the creator, used for tests and Linux clients)headless/blink-joiner/ - Desktop Blink joiner (counterpart to the creator, used for tests and Linux clients)headless/vk-bot/ - Standalone VK Long Poll bot that spawns headless creators on demand and replies with the join link (server-side alternative to the Electron bot)headless/tests/ - Live end-to-end tests (creator + joiners over a real SFU); run same-host or in a Dockerized netns stand, see headless/tests/README.mdandroid-app/ - Android joiner: VpnService + tun2socks + headless Pion (primary path); also retains a WebView fallback for the legacy browser flowios-proxy-app/ - iOS joiner: SOCKS5 + headless Pion via the gomobile xcframeworkios-vpn-app/ - iOS joiner with a system VPN: Network Extension + headless Pion, needs a signing team with the Network Extension capabilityjoiner-desktop-app/ - Electron desktop joiner for Windows / macOS / Linux: system TUN or SOCKS5 only, all six platformscreator-app/ - Electron desktop creator app: GUI front-end that can run either the legacy browser path or spawn the headless Go binaries; suitable for both interactive use and deploymentsheadless/docker/ - Docker image and compose file for the headless VK bot with all creatorsdocker-build/ - Dockerized build of the Android app, the creator app and the headless binarieshooks/ - JavaScript hooks for the legacy browser path (DC and Video modes, VK and Telemost). Headless does not use JS hooks.Prebuilt binaries are available on GitHub Releases.
Download and run the Electron app from GitHub Releases. It bundles the headless Go binaries automatically.
The tunnel mode is chosen on the joiner, the headless creator adapts to it on every connect. To run the creators on a server without a GUI, press Export Cookies and use the files with the headless binaries, see docs/SETUP.md.
VK (legacy) and Telemost (legacy) run the old browser path. There the call must be created from within the app and the tunnel mode is picked on the creator - the JS hooks must be present from the moment the call starts.
Pick whichever fits the device: