Hystron

Multi-protocol proxy management panel with TUI, CLI and REST API

Features

• Manage users with traffic limits, expiry dates and per-device (HWID) caps
• Multiple backends — Hysteria2 servers and hystron-node (xray-core over gRPC)
• Tag-based host filtering — assign tags to hosts and users; a host is only served to users sharing at least one tag
• Subscriptions auto-detect the client app and return Sing-Box, Clash or plain URI list; the browser gets an HTML dashboard with a QR code
• Per-user traffic stats: hour / day / week / month / total; auto-kick on limit exceeded
• TUI for interactive management, CLI for scripting, REST API for integrations
• Database migrations run automatically on startup (Alembic)

Install

curl -fsSL https://raw.githubusercontent.com/BX-Team/hystron/master/install.sh -o /tmp/hystron.sh \
  && sudo bash /tmp/hystron.sh install

After installation, get started by running:

hystron --help

Update / Uninstall

hystron update

curl -fsSL https://raw.githubusercontent.com/BX-Team/hystron/master/install.sh -o /tmp/hystron.sh \
  && sudo bash /tmp/hystron.sh uninstall

Protocols

Protocol	Host type
Hysteria2	hysteria2
VLESS + REALITY	hystron_node
Trojan	hystron_node

hystron_node hosts connect to a companion hystron-node process running xray-core. The panel syncs users over gRPC and polls traffic stats from each node.

License

Licensed under the MIT License.