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

Full mode (host network — all features including Rules engine)

docker run -d --name hy2scale \
  --network host --privileged \
  -v hy2scale-data:/data \
  --restart unless-stopped \
  frankoong/hy2scale:latest

Bridge mode (L2TP/IKEv2/WireGuard, no Rules engine)

docker run -d --name hy2scale \
  --cap-add NET_ADMIN --cap-add NET_RAW \
  -p 5565:5565/tcp -p 5565:5565/udp \
  -v hy2scale-data:/data \
  --restart unless-stopped \
  frankoong/hy2scale:latest

iKuai v4

Download the .ipkg from Releases and install via Applications → Application Store → Local installation. See the iKuai v4 guide for details.

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)
• TUN Mode — Raw IP packet forwarding through relay, preserving end-to-end TCP/UDP sessions for protocols like Moonlight
• Minimal Linux Compatible — Runs on stripped-down Linux systems (e.g., router firmware) in non-host Docker without --privileged
• iKuai v4 Support — Install via .ipkg package on iKuai Application Store with automatic compat mode
• 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 .

Star History