Skip to content

zZedix/Blitz-Node

 
 

Repository files navigation

Blitz Node - Hysteria2 Server Setup

Complete Hysteria2 node installation with panel integration, authentication, and traffic tracking.

Installation Steps

1. Run Installer

Clone this repository:

git clone https://github.com/ReturnFI/Blitz-Node.git
cd Blitz-Node

Make the installer executable:

chmod +x install.sh

Run the installer:

./install.sh install <port> <sni>

Example:

./install.sh install 1239 example.com

2. Configure Panel API

During 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/nodestraffic for traffic reporting

Uninstall

bash install.sh uninstall

Docker Deployment

The repository now includes Docker artifacts that run Hysteria2, the auth API, and the traffic collector together.

  1. Use the helper script to install via Docker (mirrors install.sh prompts and automation):
    chmod +x dockerize.sh
    ./dockerize.sh install 1239 example.com
    The script will:
    • 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 docker group.
    • Download the Blitz base config.json, geoip.dat, and geosite.dat.
    • Generate certificates, UUID secret, and salamander password.
    • Build images locally and launch the compose stack.
  2. 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 (default 28262).

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).

About

Node server for Blitz panel

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Shell 59.6%
  • Python 36.0%
  • Dockerfile 4.4%