
Tunelamento de dados sobre webrtc para contornar a censura
Faz o túnel do tráfego de internet através de plataformas de videochamada (VK Call, Yandex Telemost, WB Stream, DION, Bitrix24, Blink) para contornar a censura por whitelist governamental.
Guia de configuração passo a passo (em russo): docs/SETUP.md
Dois modos de túnel estão disponíveis: DC (DataChannel) e Video (codificação de dados VP8). A configuração recomendada é headless em ambas as pontas - Go puro (Pion) comunica diretamente com o SFU da plataforma, sem navegador. Ofuscação ChaCha20, pacing VP8 configurável e o backend LiveKit/WB Stream são recursos exclusivos do modo headless.
Um caminho legado via navegador (joiner Android WebView contra um criador desktop Electron com hooks JS) ainda funciona para VK DC, mas é mais lento, não consegue ofuscar e está sendo descontinuado. Novas implantações devem usar headless.
O Pion abre um SCTP DataChannel no PC publicador e faz o túnel de TCP/UDP através dele. Os frames passam pelo SFU da plataforma como qualquer outra carga útil de 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
Mesmo pipeline do modo DC, mas o túnel trafega em uma faixa de vídeo VP8 publicada em vez de um SCTP DataChannel. Útil quando o SFU limita a taxa de DataChannels mas permite a passagem de RTP (por exemplo, Telemost), e obrigatório pela plataforma em alguns casos (a faixa de publisher do WB Stream é sempre vídeo). O enquadramento do túnel e a camada de multiplexação acima dele são os mesmos do modo DC.
O modo de vídeo pode ser encapsulado em KCP (a opção Reliable do joiner, --reliable nos joiners da CLI): quadros perdidos são retransmitidos em vez de quebrar fluxos TCP em um caminho com perdas. O criador detecta isso a partir do primeiro quadro do joiner, nada a configurar desse lado. Suportado no VK, Telemost, WB Stream, Bitrix e Blink.
O tráfego passa pelo SFU da plataforma, que está na lista de permissões do governo. Para o DPI, parece uma videochamada normal.
relay/ - Relay em Go compartilhado por ambas as pontas: proxy SOCKS5, encanamento tun2socks, túnel DC/VP8, ofuscador ChaCha20, multiplexador de conexões, bindings gomobile/iOSheadless/vk/ - Criador headless do VK: cria ou entra em uma chamada via API HTTP do VK, túnel Pion DC/VP8, sem navegadorheadless/telemost/ - Criador headless do Telemost (Yandex) com o mesmo modeloheadless/wbstream/ - Criador headless do WB Stream (baseado em LiveKit, tokens de convidado anônimos)headless/dion/ - Criador headless do DION com o mesmo modeloheadless/bitrix/ - Criador headless do Bitrix (DC/VP8 adaptativo, entrada como convidado)headless/blink/ - Criador headless do Blink (baseado em LiveKit, faz login pelo app Blink)headless/wbstream-joiner/ - Joiner desktop do WB Stream (contraparte do criador, usado para testes e clientes Linux)headless/telemost-joiner/ - Joiner desktop do Telemost (contraparte do criador, usado para testes e clientes Linux)headless/dion-joiner/ - Joiner desktop do DION (contraparte do criador, usado para testes e clientes Linux)headless/bitrix-joiner/ - Joiner desktop do Bitrix (contraparte do criador, usado para testes e clientes Linux)headless/blink-joiner/ - Joiner desktop do Blink (contraparte do criador, usado para testes e clientes Linux)headless/vk-bot/ - Bot VK Long Poll autônomo que gera criadores headless sob demanda e responde com o link de entrada (alternativa do lado do servidor ao bot Electron)headless/tests/ - Testes ao vivo de ponta a ponta (criador + joiners por um SFU real); execute no mesmo host ou em um stand netns dockerizado, veja headless/tests/README.mdandroid-app/ - Joiner Android: VpnService + tun2socks + Pion headless (caminho principal); também mantém um fallback WebView para o fluxo legado de navegadorios-proxy-app/ - Joiner iOS: SOCKS5 + Pion headless via o xcframework gomobileios-vpn-app/ - Joiner iOS com VPN do sistema: Network Extension + Pion headless, requer uma equipe de assinatura com a capacidade Network Extensionjoiner-desktop-app/ - Joiner desktop Electron para Windows / macOS / Linux: apenas TUN do sistema ou SOCKS5, todas as seis plataformascreator-app/ - App criador desktop Electron: front-end GUI que pode executar o caminho legado de navegador ou gerar os binários Go headless; adequado tanto para uso interativo quanto para implantaçõesheadless/docker/ - Imagem Docker e arquivo compose para o bot VK headless com todos os criadoresdocker-build/ - Build dockerizado do app Android, do app criador e dos binários headlesshooks/ - Hooks JavaScript para o caminho legado de navegador (modos DC e Vídeo, VK e Telemost). O headless não usa hooks JS.Binários pré-compilados estão disponíveis em GitHub Releases.
Baixe e execute o app Electron em GitHub Releases. Ele inclui automaticamente os binários Go headless.
O modo túnel é escolhido no joiner, o criador headless adapta-se a ele em cada conexão. Para executar os criadores num servidor sem GUI, pressione Export Cookies e use os ficheiros com os binários headless, consulte docs/SETUP.md.
VK (legacy) e Telemost (legacy) usam o caminho antigo do navegador. Aí a chamada deve ser criada dentro da app e o modo túnel é escolhido no criador - os hooks JS devem estar presentes desde o momento em que a chamada começa.
Escolha o que se adequa ao dispositivo:
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.