DOCS/hub/Technical
How it Works (Deep Dive)
Understanding the traffic flow helps in debugging and optimizing your setup.
- Ingress: A user connects to your Gate IP (e.g.,
play.example.comon port 25565). - Packet Sniffing: The Gate accepts the TCP connection and inspects the first few bytes (without terminating SSL).
- Minecraft: Extracts the hostname from the Handshake packet.
- HTTPS: Extracts the SNI from the TLS Client Hello.
- HTTP: Extracts the Host header.
- Route Lookup: The Gate queries its routing table (InMemory or Redis) for
play.example.com. - Tunnel Selection: It finds the associated
Tunnel IDfor the active Agent (Link). - Stream Multiplexing: The Gate opens a new virtual stream inside the existing, persistent TCP tunnel to the Link.
- Forwarding: The Link receives the stream and dials the local target (e.g.,
127.0.0.1:25565). - Data Flow: Traffic flows transparently:
User <-> Gate <-> Link <-> Local Server.
ID: 17LAST UPDATED: 3/1/2026