Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/SpaceNeuroX/proxy-turn-vk-android/llms.txt

Use this file to discover all available pages before exploring further.

qWDTT is an Android VPN client and server that routes your WireGuard tunnel through VK’s TURN relay servers — the same infrastructure used for VK video calls. To deep-packet-inspection systems, your traffic looks like an encrypted WebRTC audio or video stream, not a VPN connection. This makes qWDTT effective on mobile networks that block traditional VPN protocols while allowing VK calls.

Quickstart

Install the app, deploy a server, and connect in minutes

How It Works

Understand the DTLS + WRAP + RTP obfuscation stack

Profiles & Import

Manage multiple server profiles, groups, and subscriptions

Server Setup

Deploy wdtt-server on your VPS from the Android app

Configuration Formats

wdtt://, qwdtt://, JSON profiles, and subscription feeds

Advanced Options

VK auth modes, captcha, DNS, and build instructions

What Makes qWDTT Different

qWDTT and the original WDTT protocol share the same serverwdtt-server, import links, and Telegram bot are all fully compatible. The Android client is where qWDTT adds significant improvements:

Multiple Profiles

Organize server configs into named groups with drag-and-drop reordering and per-profile ping display

Subscriptions

Subscribe to HTTPS JSON feeds that automatically refresh your profile list

Extended Import

Import via qwdtt:// links, .qwdtt files, QR codes, or batch JSON — in addition to the standard wdtt:// format

VK Account Auth

Log in with a VK account to capture TURN credentials from a real WebView session

Quick Controls

Home screen widget and Quick Settings tile for one-tap tunnel toggle

SOCKS5 Mode

Run as a local SOCKS5 proxy instead of a system VPN for selective routing

Architecture Overview

Android Phone              VK TURN Relay               Your VPS
┌─────────────┐  RTP+WRAP   ┌──────────┐  RTP+WRAP+DTLS  ┌─────────────┐
│ WireGuard   │ ──/DTLS───► │  relay   │ ───────────────►│ wdtt-server │
│ Go client   │             │  (VK)    │                 │ WireGuard   │
│ 127.0.0.1   │             └──────────┘                 └─────────────┘
└─────────────┘
Traffic flows through VK’s TURN relay using DTLS for transport security and the WRAP protocol (ChaCha20-Poly1305 inside RTP headers) for obfuscation. From the outside, each packet looks like an OPUS audio frame or H.264 video frame from a WebRTC call.
1

Get the APK

Download the latest release from GitHub Releases or build from source
2

Deploy your server

Use the Deploy tab in the app to install wdtt-server on any VPS over SSH — no manual commands needed
3

Get a VK call hash

Open a VK group call and copy the hash from the join link (vk.com/call/join/<hash>)
4

Import and connect

Paste a wdtt:// or qwdtt:// link (or scan a QR code), then tap Connect and grant VPN permission
When leaving a VK call, always choose “Just leave” — not “End for everyone” — to keep the call hash alive for future connections.

Build docs developers (and LLMs) love