ksp proxy
ksp proxy
Command ReferenceLaunch a transparent KSP-to-TCP or KSP-to-UDP local forwarder proxy.
Networking & Diagnostics
Purpose
Launch a transparent KSP-to-TCP or KSP-to-UDP local forwarder proxy.
Syntax
Command-line specificationbash / powershell
ksp proxy --listen <LOCAL_PORT> --target <REMOTE_URI> [OPTIONS]
Options & Flags
| Option Flag | Description |
|---|---|
| --listen <ADDR:PORT> | Local address and port to bind the proxy interface (e.g. `127.0.0.1:8080`). |
| --target <URI> | Remote KSP destination server to tunnel incoming traffic to. |
| --inspect | Log real-time decrypted stream metadata to stdout as frames traverse the proxy. |
Example Usage
Example command
ksp proxy --listen 127.0.0.1:8080 --target ksp://127.0.0.1:9876 --inspect
Expected Output
[+] KSP Proxy starting on 127.0.0.1:8080 [+] Upstream destination: ksp://127.0.0.1:9876 [+] Inspection mode: ACTIVE (Logging decrypted headers) [PROXY] Client connected from 127.0.0.1:54321 → Handshake completed (SessionID: 0xA91E...) [PROXY] Stream #1 OPEN | Payload: 1,024 bytes (AES-256-GCM verified) [PROXY] Stream #1 CLOSE | Total transferred: 4,096 bytes
Implementation Notes
Enables legacy HTTP or TCP applications to securely communicate over encrypted KSP tunnels without modifying application code.