How amurcanov/csqtt works
CSQTT is an Android client and Rust server for a protected tunnel carried over TURN/RTP. The user configures a connection in the app, starts it, and routes device traffic through the tunnel; server-side components provide the proxy dataplane and administrative web panel. The graph includes the client’s VPN boundary, Rust runtime, server control/dataplane, and shared framing. Some cross-process wiring and unsampled subsystems are shown only where documented; dashed links mark unverified integration.
Main entry points: rust-client/main.rs Client runtime · TunnelManager.kt Tunnel lifecycle · rust-server/main.rs Server runtime · protocol.rs Protocol service
Components 23
Android app
- App screens
app/src/main/java/com/csqtt/client/MainActivity.kt - Connection settings
app/src/main/java/com/csqtt/client/SettingsStore.kt - Tunnel lifecycle
app/src/main/java/com/csqtt/client/TunnelManager.kt - Tunnel service
app/src/main/java/com/csqtt/client/TunnelService.kt - Android VPN
app/src/main/java/com/csqtt/client/TunVpnService.kt - Captcha WebView
app/src/main/java/com/csqtt/client/CaptchaWebViewManager.kt - VK authentication
app/src/main/java/com/csqtt/client/VkAuthWebViewManager.kt
Rust client
- Client runtime
rust-client/main.rs - Credential auth
rust-client/auth.rs - Packet dispatcher
rust-client/dispatcher.rs - Session handling
rust-client/session.rs - TURN transport
rust-client/turn_core.rs - Client TUN
rust-client/tun.rs
Rust server
- Server runtime
rust-server/main.rs - Protocol service
rust-server/protocol.rs - Server dataplane
rust-server/dataplane.rs - Proxy routing
rust-server/proxy_route.rs - Transparent proxy
rust-server/tproxy.rs - Server state
rust-server/model.rs - Admin web panel
rust-server/web_panel.rs
Shared transport
- Flow framing
shared/flow_frame.rs
Other components
- User
- TURN/RTP network
Connections 27
- User → App screens: configures
- App screens → Connection settings: stores settings
app/src/main/java/com/csqtt/client/MainActivity.kt - App screens → Tunnel lifecycle: starts tunnel
app/src/main/java/com/csqtt/client/MainActivity.kt - Tunnel lifecycle → Connection settings: reads settings
app/src/main/java/com/csqtt/client/TunnelManager.kt - Tunnel service → Tunnel lifecycle: starts lifecycle
app/src/main/java/com/csqtt/client/TunnelService.kt - Tunnel service → Android VPN: starts VPN
app/src/main/java/com/csqtt/client/TunnelService.kt - Tunnel lifecycle → Captcha WebView: uses captcha
app/src/main/java/com/csqtt/client/TunnelManager.kt - User → VK authentication: authenticates
- Tunnel lifecycle → Client runtime: launches client
- Client runtime → Credential auth: uses auth
rust-client/main.rs - Client runtime → Packet dispatcher: starts dispatcher
rust-client/main.rs - Client runtime → Session handling: starts sessions
rust-client/main.rs - Client runtime → Client TUN: uses TUN
rust-client/main.rs - Client runtime → TURN transport: uses TURN
rust-client/main.rs - TURN transport → TURN/RTP network: sends tunnel traffic
- TURN/RTP network → Server runtime: reaches server
- Server runtime → Protocol service: starts protocol
rust-server/main.rs - Server runtime → Server dataplane: starts dataplane
rust-server/main.rs - Server runtime → Admin web panel: starts panel
rust-server/main.rs - Protocol service → Server state: uses state
rust-server/protocol.rs - Server dataplane → Protocol service: uses protocol
rust-server/dataplane.rs - Proxy routing → Server state: uses state
rust-server/proxy_route.rs - Proxy routing → Transparent proxy: uses proxy
rust-server/proxy_route.rs - Admin web panel → Protocol service: manages credentials
rust-server/web_panel.rs - Admin web panel → Server state: reads state
rust-server/web_panel.rs - Packet dispatcher → Flow framing: uses framing
- Server dataplane → Flow framing: uses framing