vk-turn-proxy：VK TURN 隧道代理

项目简介

Good TURN（仓库名 vk-turn-proxy）是一个用 Go 编写的命令行工具，用于把 WireGuard / Hysteria 流量通过 VK 通话（或 Yandex 远程桥接）的 TURN 服务器进行中转。数据包先用 DTLS 1.2 加密，再以多条并行流的形式，通过 TCP 或 UDP 以 STUN ChannelData 协议发送到 TURN 服务器；TURN 服务器再用 UDP 转发到你的服务器，在那里解密后交给 WireGuard。TURN 的用户名/密码由通话链接生成。

项目以服务端 server 与客户端 client 两个二进制形式发布，服务端部署在带 WireGuard 的 VPS 上，客户端在本地运行。作者声明本项目仅供学习用途。

主要功能

• 服务端 / 客户端双端架构，通过 TURN 服务器中转加密流量
• 支持 VK 通话链接自动生成 TURN 凭据（-vk-link）
• 支持 Yandex 远程桥接连链接（-yandex-link）并手动指定 TURN 地址（-turn）、UDP 模式（-udp）
• 提供服务端监听端口（-listen）与目标 WireGuard 地址（-connect / -peer）配置
• 提供 Docker 镜像（GitHub Container Registry），支持 host network 与 bridge 模式
• 提供 systemd 服务示例，可作为守护进程常驻

安装与使用

服务端

下载二进制并启动（示例为 server-linux-amd64）：

curl -L -o server https://github.com/cacggghp/vk-turn-proxy/releases/latest/download/server-linux-amd64 && chmod +x server
./server -listen 0.0.0.0:56000 -connect 127.0.0.1:<WG 端口>

Docker 方式：

docker pull ghcr.io/cacggghp/vk-turn-proxy:latest
docker tag ghcr.io/cacggghp/vk-turn-proxy:latest vkt
docker run --rm --network host -e CONNECT_ADDR=127.0.0.1:<WG 端口> vkt

环境变量 CONNECT_ADDR 为 WireGuard 地址（必填），例如 192.168.1.10:51820。也可按 README 中的 /etc/systemd/system/vk-turn-proxy.service 示例配置守护进程，然后执行 systemctl daemon-reload、systemctl enable vk-turn-proxy.service、systemctl start vk-turn-proxy.service。

客户端

下载对应架构的客户端二进制并运行：

curl -L -o client https://github.com/cacggghp/vk-turn-proxy/releases/latest/download/client-android-arm64 && chmod +x client
./client -listen 127.0.0.1:9000 -peer <WG 服务器 IP>:56000 -vk-link <VK 链接>

Yandex 远程桥接方式：

./client -udp -turn 5.255.211.241 -peer <WG 服务器 IP>:56000 -yandex-link <Ya 链接> -listen 127.0.0.1:9000

Android 可在 Termux（从 F-Droid 安装）中运行上述命令，先执行 termux-wake-lock 防止手机深度休眠；iOS 可通过 iSH Shell 安装 curl 后下载 client-linux-386 并运行。README 也列出了若干第三方 Android / iOS / macOS GUI 客户端。

WireGuard 配置

把客户端配置中服务器地址改为 127.0.0.1:9000，MTU 设为 1280；Termux 需加入 WireGuard 的排除列表。由于通话会连接 VK 的 155.212.192.0/20 等网段，需要把 AllowedIPs 从 0.0.0.0/0, ::0 改为排除这些网段的写法（README 中给出了完整的 AllowedIPs 列表）。

注意事项

• 需要一个有效的 VK 通话链接（或 Yandex 远程桥接链接）、一台已安装 WireGuard 的 VPS。
• 若开启 VPN 后终端出现 DNS 错误，可尝试在 WireGuard 中只对需要的应用启用 VPN。
• 使用 Termux 时手机不会深度休眠，夜间建议接上电源。
• 项目采用 GPL-3.0 许可证，作者声明仅供学习用途，且不对其他类似项目负责。

---

本作品整理自 GitHub 开源项目 cacggghp/vk-turn-proxy，原作者 @cacggghp，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。