Converting the pinSHA256 value from Base64 to colon-separated hexadecimal format when a v2rayNG User-Agent is detected.
🚀 Hysteria2 Management Shell Script 🚀
A powerful and user-friendly management panel for Hysteria2 proxy server. Features include complete user management, traffic monitoring, WARP integration, Telegram bot support, and multiple subscription formats. Simple installation with advanced configuration options for both beginners and experienced users.
🛡️ Key features:
- 🔐 Complete user lifecycle management
- 📊 Real-time traffic monitoring
- 🌐 WARP integration
- 🤖 Telegram bot support
- 🔄 Multiple subscription formats
- 🚄 TCP Brutal optimization
- 🌍 Geo-based routing
- 🔒 OBFS (Obfuscation)
- 📱 Mobile-friendly URIs
📋 Quick Start Guide
One-Click Installation
bash <(curl https://raw.githubusercontent.com/ReturnFI/Hysteria2/main/install.sh)
After installation, use hys2 to launch the management panel.
There is no need to execute the installation command again.
Upgrade to Latest Version
bash <(curl https://raw.githubusercontent.com/ReturnFI/Hysteria2/main/upgrade.sh)
🔧 System Requirements
| Component | Minimum Requirement |
|---|---|
| OS | Debian 11+ / Ubuntu 22+ |
| Architecture | x86_64, ARM64 |
| RAM | 1GB |
| Storage | 10GB free space |
| Network | IPv4/IPv6 compatible |
| Access | Root privileges required |
✨ Features
-
Core Features
- Easy installation and configuration of Hysteria2 server
- Complete user management system
- Traffic monitoring and statistics
- Advanced WARP integration
- Multiple subscription formats support
- Telegram bot integration
-
User Management
- Add/Edit/Remove users
- Traffic quota management
- Account expiration control
- User traffic statistics
- Reset user data
- Block/Unblock users
- Generate user connection URIs
-
System Features
- TCP Brutal installation support
- WARP configuration and management
- SNI and port management
- IPv4/IPv6 address management
- OBFS (Obfuscation) management
- Subscription link generation (SingBox and Normal-SUB)
-
Monitoring & Control
- Service status monitoring
- Traffic status tracking
- System resource usage display
- Automated updates
- Core version management
🎯 Main Menu
System Information Display
The main screen shows important system details:
- OS and Architecture
- ISP and CPU information
- IP address
- RAM usage
- Hysteria2 Core Version
- Current service status
Main Options
| Option | Description |
|---|---|
[1] |
Hysteria2 Menu - Core functionality management |
[2] |
Advance Menu - Additional features and configurations |
[3] |
Update Panel - Updates the management panel |
[0] |
Exit |
🚀 Hysteria2 Menu
Installation and Basic Management
-
Install and Configure Hysteria2
- Initial setup and configuration
- Parameters:
- SNI (default: bts.com)
- Port number
-
Add User
- Create new user accounts
- Required information:
- Username (alphanumeric only) - Traffic limit (GB) - Expiration days - System automatically generates a secure password
-
Edit User
- Modify existing accounts:
- Username - Traffic limit - Expiration period - Password (regenerate) - Creation date (reset) - Block status
- Modify existing accounts:
-
Reset User
- Reset user traffic statistics
-
Remove User
- Delete user accounts
User Information
-
Get User
- Detailed user information:
- Username & password - Traffic allocation - Current usage - Creation date - Expiration status - Block status
- Detailed user information:
-
List Users
- Complete user database in table format
- Shows:
- Traffic limits - Expiration dates - Creation dates
-
Check Traffic Status
- Current traffic usage monitoring
-
Show User URI
- Connection information
- QR code generation
⚙️ Advance Menu
Network Optimization
- TCP Brutal Installation
- TCP optimization setup
WARP Management
-
Install WARP
- WARP service installation
-
Configure WARP Options:
- All traffic routing - Popular sites routing - Domestic sites routing - Adult content blocking - WARP Plus profile - Normal profile - Status check - IP address change -
Uninstall WARP
- Remove WARP service
Service Management
-
Telegram Bot
- Start/stop bot service - Bot token configuration - Admin ID settings -
SingBox SubLink
- Service start/stop - Domain configuration - Port settings -
Normal-SUB SubLink
- Service start/stop - Domain configuration - Port settings
System Configuration
-
Change Port Hysteria2
- Modify service port
-
Change SNI Hysteria2
- Update SNI settings
-
Manage OBFS
- Remove OBFS - Generate new OBFS -
Change IPs(4-6)
- IPv4/IPv6 address modification
-
Update geo Files
- Geolocation database update
System Maintenance
-
Restart Hysteria2
- Service restart
-
Update Core Hysteria2
- Core system update
-
Uninstall Hysteria2
- Complete system removal
💡 Usage Tips
Navigation
- Use
[0]to return to previous menu - Press
Enterafter operations to continue - Invalid inputs will prompt for correction
- Service status visible in main menu
Color Coding
The interface uses colors for quick identification:
🟢 Green: Installation options
🔵 Cyan: Configuration options
🔴 Red: Removal/exit options
🟡 Yellow: Menu titles and prompts
🔄 Client Compatibility
| Client | Supported Versions | Supported OS |
|---|---|---|
| SingBox | 1.10.5 (Dec 21, 2024) | Linux, macOS, iOS, Android |
| Hiddify | Latest | Windows, Linux, macOS, iOS, Android |
| Sterisand | Latest | iOS |
| Nekobox | Latest | Android |
| Nekoray | Latest | Windows, Linux |
🤝 Contributing
We welcome contributions! Here's how you can help:
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Open a Pull Request
⚠️ Disclaimer
This tool is provided for educational and research purposes only. Users are responsible for:
- Complying with local laws and regulations
- Ensuring appropriate usage of proxy servers
- Maintaining server security
- Protecting user privacy
🙏 Acknowledgments
- Hysteria2 Core Team
- Community Members
- @Iam54r1n4
Made with ❤️
فارسی