Complete Hysteria2 node installation with panel integration, authentication, and traffic tracking.
Clone this repository:
git clone https://github.com/ReturnFI/Blitz-Node.git
cd Blitz-NodeMake the installer executable:
chmod +x install.shRun the installer:
./install.sh install <port> <sni>Example:
./install.sh install 1239 example.comDuring installation, provide:
- Panel URL:
https://your-panel.com/your-path/ - API Key: Your panel authentication key
The installer automatically appends:
/api/v1/users/for user authentication/api/v1/config/ip/nodestrafficfor traffic reporting
bash install.sh uninstallThe repository now includes Docker artifacts that run Hysteria2, the auth API, and the traffic collector together.
- Use the helper script to install via Docker (mirrors
install.shprompts and automation):The script will:chmod +x dockerize.sh ./dockerize.sh install 1239 example.com
- Ask for panel URL and API key, then populate
.env. - Install Docker, Docker Compose (plugin or standalone), and core utilities automatically on apt-based systems if they are missing. You may need to log out/back in if you weren't previously in the
dockergroup. - Download the Blitz base
config.json,geoip.dat, andgeosite.dat. - Generate certificates, UUID secret, and salamander password.
- Build images locally and launch the compose stack.
- Ask for panel URL and API key, then populate
- To stop and remove everything, run:
./dockerize.sh uninstall
The compose file exposes:
- Hysteria2 on
HYSTERIA_PORT(UDP) for client connections. - The auth API on
AUTH_PORT(default28262).
The traffic collector runs on the configured interval and reaches Hysteria via the internal service name (http://hysteria:25413 by default). Override additional variables in .env as needed (for example SYNC_INTERVAL, HYSTERIA_API_BASE, or HYSTERIA_CONFIG_FILE).