How syss-research/turnado works
TURNado is a command-line suite for assessing TURN servers and relaying traffic through them. The user selects a mode; the CLI dispatches it to probes such as server inspection and TCP scanning, or to traffic-relay modes such as SOCKS, IP tunneling, and UDP forwarding. Shared control-connection setup supports TURN operations, while paired tunnels add peer exchange, secure transport, and reliability. The README documents these capabilities, but several mode implementations were not excerpted, so internal links to them are left unverified.
Main entry points: modes.go Mode registry · tunnel.go IP tunnel mode · tunnel_transport.go Peer transport · tunnel_reliable.go SOCKS mode
Components 24
CLI and modes
- Command entry
cmd/turnado/main.go - Mode registry
internal/app/modes.go
TURN assessment
- Server inspection
internal/app/info.go - Probe reporting
internal/app/info_report.go - TCP target scan
internal/app/scan.go - Allocation load test
internal/app/dos.go
Traffic relaying
- UDP forwarding
internal/app/forward.go - SOCKS mode
internal/app/tunnel_reliable.go - Direct SOCKS
internal/app/direct_socks.go - IP tunnel mode
internal/app/tunnel.go
Tunnel internals
- TURN control setup
internal/app/common.go - Peer pairing
internal/app/tunnel_auto.go - Connection strings
internal/app/connstr.go - Peer transport
internal/app/tunnel_transport.go - DTLS and SRTP
internal/app/tunnel_secure.go - Reliable streams
internal/app/tunnel_reliable.go - SOCKS UDP
internal/app/tunnel_udp.go - TUN packet relay
internal/app/tunnel_tun.go - Platform TUN device
internal/app/tun_linux.go
Other components
- Operator
- TURN server
- SOCKS client
- TCP or UDP target
- IP network
Connections 29
- Operator → Command entry: selects mode
README.md - Command entry → Mode registry: looks up and runs
cmd/turnado/main.go - Mode registry → Server inspection: dispatches
- Mode registry → TCP target scan: dispatches
- Mode registry → SOCKS mode: dispatches
- Mode registry → IP tunnel mode: dispatches
- Mode registry → UDP forwarding: dispatches
- Mode registry → Allocation load test: dispatches
- Server inspection → TURN server: probes
README.md - Server inspection → Probe reporting: reports results
- TCP target scan → TURN server: sends CONNECT
README.md - TURN server → TCP or UDP target: attempts TCP connection
README.md - Allocation load test → TURN server: creates allocations
README.md - UDP forwarding → TURN server: relays UDP through
README.md - UDP forwarding → TCP or UDP target: forwards traffic
README.md - SOCKS client → SOCKS mode: opens SOCKS proxy
README.md - SOCKS mode → TURN server: uses TURN
README.md - SOCKS mode → TCP or UDP target: relays TCP to
README.md - Direct SOCKS → TURN server: uses RFC 6062
README.md - IP tunnel mode → TURN server: allocates relay
README.md - IP tunnel mode → IP network: tunnels IP traffic
README.md - IP tunnel mode → Peer pairing: pairs peers
- Peer pairing → Connection strings: exchanges strings
- Peer pairing → Peer transport: pairs relay
- Peer transport → DTLS and SRTP: secures peer traffic
- Peer transport → Reliable streams: carries reliable data
- Reliable streams → SOCKS UDP: handles UDP associate
- Peer transport → TUN packet relay: carries IP packets
- TUN packet relay → Platform TUN device: reads and writes