
WebRTC를 통해 데이터를 터널링하여 검열 우회
정부의 화이트리스트 검열을 우회하기 위해 영상 통화 플랫폼(VK Call, Yandex Telemost, WB Stream, DION, Bitrix24, Blink)을 통해 인터넷 트래픽을 터널링합니다.
단계별 설정 가이드(러시아어): docs/SETUP.md
두 가지 터널 모드를 사용할 수 있습니다: DC(DataChannel)와 Video(VP8 데이터 인코딩). 권장 설정은 양쪽 모두 헤드리스 방식입니다. 순수 Go(Pion)가 브라우저 없이 플랫폼의 SFU와 직접 통신합니다. ChaCha20 난독화, 구성 가능한 VP8 페이싱, LiveKit/WB Stream 백엔드는 헤드리스 전용 기능입니다.
레거시 브라우저 경로(JS 훅이 있는 Electron 데스크톱 생성자에 대해 Android WebView 조이너를 사용)는 여전히 VK DC에서 작동하지만, 더 느리고 난독화를 할 수 없으며 단계적으로 폐지되고 있습니다. 새로운 배포에서는 헤드리스를 사용해야 합니다.
Pion은 퍼블리셔 PC에서 SCTP DataChannel을 열고 이를 통해 TCP/UDP를 터널링합니다. 프레임은 다른 DataChannel 페이로드와 마찬가지로 플랫폼의 SFU를 통과합니다.
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
DC 모드와 동일한 파이프라인이지만, 터널이 SCTP DataChannel 대신 게시된 VP8 비디오 트랙 위에서 동작합니다. SFU가 DataChannel의 속도를 제한하지만 RTP는 허용하는 경우(예: Telemost)에 유용하며, 일부 경우에는 플랫폼상 필수입니다(WB Stream의 게시자 트랙은 항상 비디오입니다). 터널 프레이밍과 그 위의 멀티플렉스 계층은 DC 모드와 동일합니다.
비디오 모드는 KCP로 감쌀 수 있습니다(조이너의 Reliable 옵션, CLI 조이너에서는 --reliable). 손실이 있는 경로에서 TCP 스트림이 끊기는 대신 손실된 프레임이 재전송됩니다. 크리에이터는 조이너의 첫 프레임에서 이를 감지하므로 해당 측에서는 설정할 것이 없습니다. VK, Telemost, WB Stream, Bitrix, Blink에서 지원됩니다.
트래픽은 정부 화이트리스트에 포함된 플랫폼의 SFU를 통과합니다. DPI 입장에서는 일반 영상 통화처럼 보입니다.
relay/ - 양쪽 끝에서 공유하는 Go 릴레이: SOCKS5 프록시, tun2socks 연결, DC/VP8 터널, ChaCha20 난독화기, 연결 멀티플렉서, gomobile/iOS 바인딩headless/vk/ - 헤드리스 VK 크리에이터: VK HTTP API로 통화를 생성하거나 참여하며, Pion DC/VP8 터널을 사용하고 브라우저가 필요 없음headless/telemost/ - 동일한 모델의 헤드리스 Telemost(Yandex) 크리에이터headless/wbstream/ - 헤드리스 WB Stream 크리에이터(LiveKit 기반, 익명 게스트 토큰)headless/dion/ - 동일한 모델의 헤드리스 DION 크리에이터headless/bitrix/ - 헤드리스 Bitrix 크리에이터(적응형 DC/VP8, 게스트 참여)headless/blink/ - 헤드리스 Blink 크리에이터(LiveKit 기반, Blink 앱을 통해 로그인)headless/wbstream-joiner/ - 데스크톱 WB Stream 조이너(크리에이터의 대응 구성 요소, 테스트 및 Linux 클라이언트에 사용)headless/telemost-joiner/ - 데스크톱 Telemost 조이너(크리에이터의 대응 구성 요소, 테스트 및 Linux 클라이언트에 사용)headless/dion-joiner/ - 데스크톱 DION 조이너(크리에이터의 대응 구성 요소, 테스트 및 Linux 클라이언트에 사용)headless/bitrix-joiner/ - 데스크톱 Bitrix 조이너(크리에이터의 대응 구성 요소, 테스트 및 Linux 클라이언트에 사용)headless/blink-joiner/ - 데스크톱 Blink 조이너(크리에이터의 대응 구성 요소, 테스트 및 Linux 클라이언트에 사용)headless/vk-bot/ - 요청 시 헤드리스 크리에이터를 실행하고 참여 링크로 응답하는 독립형 VK Long Poll 봇(Electron 봇의 서버 측 대안)headless/tests/ - 실제 SFU를 통한 라이브 종단 간 테스트(크리에이터 + 조이너); 동일 호스트 또는 Docker화된 netns 스탠드에서 실행, headless/tests/README.md 참조android-app/ - Android 조이너: VpnService + tun2socks + 헤드리스 Pion(기본 경로); 레거시 브라우저 흐름을 위한 WebView 폴백도 유지ios-proxy-app/ - iOS 조이너: gomobile xcframework를 통한 SOCKS5 + 헤드리스 Pionios-vpn-app/ - 시스템 VPN을 사용하는 iOS 조이너: Network Extension + 헤드리스 Pion, Network Extension 기능이 있는 서명 팀 필요joiner-desktop-app/ - Windows / macOS / Linux용 Electron 데스크톱 조이너: 시스템 TUN 또는 SOCKS5 전용, 6개 플랫폼 모두 지원creator-app/ - Electron 데스크톱 크리에이터 앱: 레거시 브라우저 경로를 실행하거나 헤드리스 Go 바이너리를 실행할 수 있는 GUI 프런트엔드; 대화형 사용과 배포 모두에 적합headless/docker/ - 모든 크리에이터와 함께 헤드리스 VK 봇을 위한 Docker 이미지 및 compose 파일docker-build/ - Android 앱, 크리에이터 앱 및 헤드리스 바이너리의 Docker화된 빌드hooks/ - 레거시 브라우저 경로용 JavaScript 훅(DC 및 비디오 모드, VK 및 Telemost). 헤드리스는 JS 훅을 사용하지 않음미리 빌드된 바이너리는 GitHub Releases에서 이용할 수 있습니다.
GitHub Releases에서 Electron 앱을 다운로드하여 실행하세요. 헤드리스 Go 바이너리가 자동으로 포함되어 있습니다.
터널 모드는 조이너에서 선택되며, 헤드리스 생성자는 연결할 때마다 이에 맞춰 적응합니다. GUI가 없는 서버에서 생성자를 실행하려면 Export Cookies를 누르고 해당 파일을 헤드리스 바이너리와 함께 사용하세요. 자세한 내용은 docs/SETUP.md를 참조하세요.
VK (레거시) 및 **Telemost (레거시)**는 이전 브라우저 경로로 실행됩니다. 여기서는 통화가 앱 내에서 생성되어야 하며 터널 모드는 생성자에서 선택됩니다. JS 훅은 통화가 시작되는 순간부터 존재해야 합니다.
기기에 맞는 것을 선택하세요:
whitelist-bypass.apk를 설치하세요. 통화 목록에 참가 링크를 추가하고 Connect를 탭한 뒤 VPN 프롬프트를 허용하세요. 시스템 전체 트래픽이 통화를 통해 흐릅니다.whitelist-bypass-vpn.ipa는 Android 앱처럼 시스템 VPN을 실행합니다. Network Extension을 사용하므로 해당 기능이 있는 팀이 서명해야 하며, 무료 Apple 계정에는 이 기능이 없습니다.whitelist-bypass-proxy.ipa (AltStore / Sideloadly / 무료 개발자 계정으로 사이드로드). 로컬 SOCKS5 프록시만 노출합니다. 기기 전체를 프록시하려면 SOCKS5를 지원하는 VPN 앱(Happ, Shadowrocket, Streisand, ...)을 앱이 표시하는 SOCKS5 엔드포인트로 지정하거나, 앱별로 프록시를 설정하세요(Telegram은 기본 지원).WhitelistBypass Joiner. 호스트 전체에 시스템 TUN 터널을 설정하거나 로컬 SOCKS5 프록시만 설정합니다.whitelist-bypass-cli-<os>-<arch>.zip 아카이브에는 Linux 및 FreeBSD용 헤드리스 조이너가 들어 있습니다. 각각 지정된 포트에서 SOCKS5 프록시를 노출하며, 원하는 대상에 연결할 수 있습니다. 서버와 라우터에 유용합니다. 선택 사항인 --socks-user / --socks-pass로 SOCKS5 사용자 이름/비밀번호 인증을 활성화할 수 있습니다. VK용 CLI 조이너는 없으며, VK 참가는 수동으로 캡차를 풀어야 합니다.
headless-wbstream-joiner --room <link> --socks-port 1080 [--socks-user u --socks-pass p]headless-telemost-joiner --tm-link <link> --socks-port 1080 [--socks-user u --socks-pass p]headless-dion-joiner --room <link> --socks-port 1080 [--socks-user u --socks-pass p]headless-bitrix-joiner --link <link> --socks-port 1080 [--socks-user u --socks-pass p]headless-blink-joiner --room <link> --cookies cookies-blink-joiner.json --socks-port 1080 [--socks-user u --socks-pass p]; 먼저 --login --cookies cookies-blink-joiner.json으로 실행하세요전체 단계별 안내(러시아어)는 각 플랫폼을 자세히 다룹니다: docs/SETUP.md를 참조하세요.
go install golang.org/x/mobile/cmd/gomobile@latest)go install golang.org/x/mobile/cmd/gobind@latest)# Full release build (Android APK + Creator app + CLI zips + Joiner app + iOS IPAs on macOS)
./make-release.sh
# Individual builds
./build-go.sh # Go .aar, Android relay, headless creators
./copy-hooks.sh # Copy JS hooks to android assets
./build-android.sh # Android APK
./build-headless.sh # Headless binaries only (current platform)
./build-cli.sh # Per-OS/arch zips of headless creators + joiners + vk-bot
./build-creator.sh # Creator Electron app (all platforms)
./build-joiner-app.sh # Joiner Electron app (all platforms), builds its Go backend too
./build-ios.sh proxy # iOS proxy app, xcframework + unsigned IPA
./build-ios.sh vpn # iOS VPN app, xcframework + unsigned IPA
Xcode와 macOS가 필요합니다. build-ios.sh는 proxy 또는 vpn 중 하나의 인수를 받습니다.
./build-ios.sh proxy # ios-proxy-app -> prebuilts/whitelist-bypass-proxy.ipa
./build-ios.sh vpn # ios-vpn-app -> prebuilts/whitelist-bypass-vpn.ipa
스크립트는 Mobile.xcframework를 앱 디렉터리에 빌드하고, 앱의 strip-signing.sh를 실행하여 프로젝트에서 개발자 팀을 제거하며, 앱을 서명 없이 빌드하고, 서명되지 않은 IPA를 prebuilts/에 기록합니다.
기기에서 실행하려면 Xcode에서 해당 .xcodeproj를 열고 Signing & Capabilities에서 팀과 고유 번들 식별자를 설정한 후 빌드하십시오. vpn 변형은 번들 식별자에 Network Extension 기능이 필요합니다.
prebuilts/의 출력: