通过视频通话平台(VK Call、Yandex Telemost、WB Stream、DION、Bitrix24、Blink)隧道传输互联网流量,以绕过政府白名单审查。
分步安装指南(俄语):docs/SETUP.md
提供两种隧道模式:DC(DataChannel)和 Video(VP8 数据编码)。推荐的配置是两端均无头运行——纯 Go(Pion)直接与平台的 SFU 通信,无需浏览器。ChaCha20 混淆、可配置的 VP8 节奏控制以及 LiveKit/WB Stream 后端均为仅限无头模式的功能。
旧版浏览器路径(Android WebView 加入端对接带 JS 钩子的 Electron 桌面创建端)对 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 模式使用相同的管道,但隧道承载在已发布的 VP8 视频轨道上,而不是 SCTP DataChannel。当 SFU 对 DataChannel 限速但允许 RTP 通过时(例如 Telemost)很有用,在某些情况下也是平台强制要求的(WB Stream 的发布者轨道始终是视频)。隧道帧格式及其上层的多路复用层与 DC 模式相同。
视频模式可以封装在 KCP 中(加入方的 Reliable 选项,CLI 加入方的 --reliable):在有损路径上,丢失的帧会被重传,而不是中断 TCP 流。创建方从加入方的第一帧中检测到这一点,该侧无需任何配置。支持 VK、Telemost、WB Stream、Bitrix 和 Blink。
流量经过平台的 SFU,而该 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.mdandroid-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,支持全部六个平台creator-app/ - Electron 桌面创建方应用:GUI 前端,可运行旧版浏览器路径或启动无头 Go 二进制文件;既适合交互使用,也适合部署headless/docker/ - 包含所有创建方的无头 VK 机器人的 Docker 镜像和 compose 文件docker-build/ - Android 应用、创建方应用和无头二进制文件的 Docker 化构建hooks/ - 旧版浏览器路径(DC 和视频模式,VK 和 Telemost)的 JavaScript 钩子。无头模式不使用 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 加入端,其加入需要手动解决验证码。
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 中设置你的团队和唯一的 bundle 标识符,然后构建。vpn 变体需要在其 bundle 标识符上启用 Network Extension 能力。
prebuilts/ 中的输出: