How diniboy1123/usque works
Usque registers and enrolls a Cloudflare WARP device, saves its credentials and tunnel settings, then exposes WARP connectivity through native TUN, SOCKS5, HTTP proxy, TCP-only L4 proxy, or port forwarding modes. The graph also shows account management and shared MASQUE/tunnel, configuration, and proxy-server layers. Connections among modes and runtime layers are documented or supported by the indexed imports; unsampled implementation details are not inferred.
Main entry points: main.go CLI entry · config.go Saved settings · socks.go SOCKS5 proxy · nativetun.go Native TUN
Components 18
Account lifecycle
- Register device
cmd/register.go - Enroll key
cmd/enroll.go - Account tools
cmd/account.go - Cloudflare API
api/cloudflare.go
Tunnel runtime
- MASQUE transport
api/masque.go - Tunnel forwarding
api/tunnel.go
Traffic modes
- Native TUN
cmd/nativetun.go - SOCKS5 proxy
cmd/socks.go - HTTP proxy
cmd/httpproxy.go - L4 proxies
cmd/l4_helpers.go - L4 HTTP handler
cmd/l4_http_proxy.go - Port forwarding
cmd/portfw.go
Shared services
- Saved settings
config/config.go - Endpoint selection
config/endpoints.go - SOCKS5 server
internal/socks5.go
Other components
- CLI user
- CLI entry
main.go - Cloudflare WARP
Connections 28
- CLI user → CLI entry: runs
main.go - CLI entry → Register device: dispatches
- CLI entry → Enroll key: dispatches
- CLI entry → Account tools: dispatches
- CLI entry → Native TUN: dispatches
- CLI entry → SOCKS5 proxy: dispatches
- CLI entry → HTTP proxy: dispatches
- CLI entry → L4 proxies: dispatches
- CLI entry → Port forwarding: dispatches
- Register device → Cloudflare API: registers and enrolls
cmd/register.go - Enroll key → Cloudflare API: enrolls key
cmd/enroll.go - Account tools → Cloudflare API: queries account
cmd/account.go - Cloudflare API → Cloudflare WARP: sends requests
api/cloudflare.go - Register device → Saved settings: saves settings
cmd/register.go - Enroll key → Saved settings: updates settings
cmd/enroll.go - Native TUN → Saved settings: reads settings
- SOCKS5 proxy → Saved settings: reads settings
cmd/socks.go - HTTP proxy → Saved settings: reads settings
- Port forwarding → Saved settings: reads settings
cmd/portfw.go - SOCKS5 proxy → Endpoint selection: selects endpoint
cmd/socks.go - Native TUN → Endpoint selection: selects endpoint
cmd/nativetun.go - MASQUE transport → Cloudflare WARP: connects to
- Native TUN → Tunnel forwarding: forwards packets
- SOCKS5 proxy → Tunnel forwarding: uses tunnel
- HTTP proxy → Tunnel forwarding: uses tunnel
- Port forwarding → Tunnel forwarding: uses tunnel
- SOCKS5 proxy → SOCKS5 server: starts server
cmd/socks.go - L4 proxies → L4 HTTP handler: supports handler
cmd/l4_http_proxy.go