
WebRTC経由でデータをトンネリングして検閲を回避する
政府のホワイトリスト検閲を回避するため、ビデオ通話プラットフォーム(VK Call、Yandex Telemost、WB Stream、DION、Bitrix24、Blink)を経由してインターネットトラフィックをトンネリングします。
ステップバイステップのセットアップガイド(ロシア語):docs/SETUP.md
2つのトンネルモードが利用可能です: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参加側: SOCKS5 + gomobile xcframework経由のヘッドレス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バイナリが自動的に同梱されています。
トンネルモードは joiner 側で選択され、ヘッドレス作成側は接続のたびにそれに適応します。GUI のないサーバーで作成側を実行するには、Export Cookies を押し、そのファイルをヘッドレスバイナリで使用してください。詳細は docs/SETUP.md を参照してください。
VK (legacy) と Telemost (legacy) は古いブラウザ経路で動作します。そこでは通話をアプリ内から作成する必要があり、トンネルモードは作成側で選択されます。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 用のヘッドレス joiner が含まれています。それぞれが指定ポートで SOCKS5 プロキシを公開し、任意の接続先をそこに向けられます。サーバーやルーターに便利です。オプションの --socks-user / --socks-pass で SOCKS5 のユーザー名/パスワード認証を有効にできます。VK 用の CLI joiner はありません。その参加には手動で解くキャプチャが必要です。
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 のいずれか 1 つの引数を取ります。
./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/ に書き出します。
デバイス上で実行するには、対応する .xcodeproj を Xcode で開き、Signing & Capabilities でチームと一意のバンドル識別子を設定してビルドします。vpn バリアントでは、そのバンドル識別子に Network Extension 機能が必要です。
prebuilts/ 内の出力: