HY2 SCALE

Hysteria 2 mesh relay network with web management UI.
Route traffic through any node, run VPN services, manage everything from a browser.

English | 한국어

Documentation

Wiki — Full documentation including installation, configuration, API reference, and more.

Quick Start

docker run -d --name hy2scale \
  --network host --cap-add NET_ADMIN \
  -v hy2scale-data:/data \
  frankoong/hy2scale:latest

Open http://<host>:5565/scale/ — default login: admin / admin

Features

• Mesh Network — Decentralized peer-to-peer topology over Hysteria 2 QUIC tunnels with nested discovery
• Exit Routing — Per-user traffic routing through any node or multi-hop chains
• VPN Protocols — L2TP/IPsec, IKEv2, WireGuard, SOCKS5, Shadowsocks — all with native OS client support
• Routing Rules — IP and domain-based traffic routing through specific exit nodes
• TLS & CA — Certificate management with CA signing for IKEv2
• Web UI — Single-page dashboard with real-time topology, traffic monitoring, and i18n (EN/KO)
• Minimal Linux Compatible — Runs on stripped-down Linux systems (e.g., router firmware) in non-host Docker without --privileged
• Hot Reload — L2TP, IKEv2, WireGuard, proxies all reload without container restart

Screenshots

Architecture

              ┌──────────┐
              │   Hub    │
              └────┬─────┘
         ┌─────────┼──────────┐
    ┌────┴───┐ ┌───┴────┐ ┌───┴────────┐
    │Japan-01│ │  SG-01 │ │ native-hy2 │
    └───┬────┘ └───┬────┘ └────────────┘
     ┌──┴──┐    ┌──┴──┐       [NATIVE]
    US-01 US-02 AU-01
                 │
                NZ-01

Building

git clone https://github.com/FrankoonG/hy2scale.git
cd hy2scale
docker build -t hy2scale .

License

MIT