frp-shSocial P2P Hole-Punching Tunnel

Host creates a room, friends join by code — UDP hole punching with automatic relay fallback. Pure Rust, single binary.

Quickstart

Architecture

GitHub

Room-based social networking

A game-xxxxxx room code is all you need — no public IP or port forwarding

UDP hole punching

STUN-lite public probing + simultaneous PUNCH/ACK handshake, works through restricted cone NAT

End-to-end encryption

A matching --key passphrase enables ChaCha20-Poly1305 transport

Relay fallback

Automatic TCP relay when punching fails; late-direct re-check heals asymmetric cases

Multi-connection reuse

One session carries sequential TCP connections; reconnect in seconds

Single static binary

~5 MB pure-Rust binary, no frp / libp2p / webrtc dependencies

Install

One-line install / update (same link for both — re-run to update; the script detects your OS and architecture and downloads the latest release from GitHub):

Linux / macOSWindows (PowerShell)

bash

curl -fsSL https://frp.sh/install.sh | sh

powershell

irm https://frp.sh/install.ps1 | iex

After installing, run frp-sh and follow the interactive setup wizard to configure your signaling server.