2.5.0

📦 ** Release 2.5.0 — ACL & WARP fixes, safer password generation, service controls 🚀**

Released: 2025-12-19

✨ New Features

🧠 Core & Service Management

• 🔍 Added Hysteria2 core version detection and validation
• 📊 Display core version directly in the web panel
• 🔁 Added Restart Hysteria2 button in the web UI with proper fetch handling
• 🔌 New API endpoint to restart Hysteria2 service programmatically

🌍 Geo & ACL Rule Management

• 🗺️ Enhanced Geo file update process with intelligent ACL rule handling
• 🧩 Added geo rule detection & auto-update for ACL configurations
• 🧹 Removed redundant geoip / geosite rejection rules
• 🚫 Removed speedtest-related rejection from ACL rules

🛡️ Security & Password Handling

• 🔐 Replaced pwgen with Python secrets module for secure password generation

• 🔑 Improved password generation for:

  • add-user
  • bulk users
  • internal password utilities

• 🧪 Removed implicit password auto-generation where not required

🧰 CLI Improvements

• 📤 Added run_cmd_and_stream for real-time command output streaming

• ⚙️ Improved error messages during Hysteria2 installation

• 🔁 Updated install scripts to return meaningful output messages

• 🔒 Replaced pwgen with openssl for:

  • obfs password generation
  • normalsub path generation

🌐 Network & IP Detection

• 🌍 Added ip.sb fallback for public IP detection to improve reliability

---

🐛 Fixes & Improvements

👤 User & Username Handling

• ✅ Allowed underscores (_) in usernames
• 🧼 Improved validation regex and error handling
• 🔧 Updated remove-user command syntax
• 🧠 Improved user handler robustness

🎭 Masquerade & OBFS

• 🚫 Prevented OBFS usage when masquerade is enabled to avoid conflicts

🧹 Scheduler & System Stability

• 🔇 Suppressed noisy systemctl output during scheduler setup
• 🧯 Improved rule-checking logic for WARP configuration status

🧼 Uninstall & Cleanup

• ♻️ Improved WARP uninstall flow:

  • Better config loading & error handling
  • Automatic ACL rule reset after uninstall

---

📦 Dependency Updates

• ⬆️ FastAPI → 0.124.4
• ⬆️ Certbot → 5.2.2
• ⬆️ python-multipart → 0.0.21

2.4.11

🚀 Release 2.4.11 — Masquerade Status, Flexible Sub Paths & Enhanced Password Security

Released: 2025-12-07

🎭 Masquerade Enhancements

• 🔧 Added masquerade controls & real-time status indicator to the Hysteria settings page
• 🔄 Updated API endpoints with improved masquerade handling
• ⚙️ Added a new core status check for masquerade
• 🧹 Refactored masquerade logic to string-based mode

🔗 Flexible Subscription Paths

• 🌐 Implemented path-based normalsub URLs, enabling more flexible subscription structures
• ♻️ Added automatic backward compatibility migration for old paths

🔐 Password Security Improvements (Thanks to @YerdosNar 🙌)

• 🔁 Added password confirmation loop for safety
• 🕶️ Enabled masked input during password entry
• ✔️ General improvements to password validation flow

---

🛠️ Fixes & Cleanup

• 🧹 Removed outdated comment blocks
• 🔇 Commented out old debug print statements

---

📦 Dependency Updates

• ⬆️ fastapi → 0.123.9
• ⬆️ pymongo → 4.15.5
• ⬆️ certbot → 5.2.1

2.4.10

🎉 Release 2.4.10 — Better Upgrades, Cleaner UI & Support Link

Released: 2025-11-28

💖 Donation & Support

• 🆕 Added “Support Us” link in the sidebar
• 💸 Introduced a donation modal to help support project development

---

🎨 User Interface

• 🎨 Fixed QR code type label colors — now uses muted text for better readability
• 🔍 Cleaned up URI display by commenting out broken hysteria-server service checks

🔧 Upgrade Improvements

• 📦 Enhanced Caddy installation process
• 🔁 Added handling for existing Caddy services to prevent conflicts
• 🔐 Updated Caddy repo & GPG key management for compatibility with new upstream changes

---

📦 Dependency Updates

• ⬆️ Bumped pydantic → 2.12.5
• ⬆️ Bumped fastapi → 0.122.0

2.4.9

📦 Release 2.4.9 — Smarter Upgrades & Cleaner UI

Released: 2025-11-21

🛠️ Fixes & Improvements

🔧 Upgrade System Enhancements

• 🛠️ Automatically fixes outdated Caddy repository URLs to prevent installation/upgrade failures
• 🔄 Ensures smoother system upgrades on all supported distros

📦 Dependency & Installation Updates

• 🆙 Updated Caddy installation command to follow the latest recommended upstream method
• 🛡️ Improves reliability and compatibility for new deployments

🎨 Frontend Improvements

• ✨ Added conditional rendering for URI cards in the subpage UI
• 📱 Prevents empty or irrelevant sections from appearing
• 🧼 Creates a cleaner, more user-friendly interface

2.4.8

📦 Release 2.4.8 — Web Panel Config Manager & WARP Logging Upgrade

Released: 2025-11-21

🛠️ Web Panel Configuration Management

• ✨ Added new configuration management functions to the web panel
• 🧩 Centralizes settings logic for easier maintenance
• 🖥️ Prepares the panel for future advanced configuration features
• 🔧 Improves backend–frontend consistency and reduces duplicated logic

---

🐍 WARP Logging Refactor

• 🔄 Replaced custom, ad-hoc logging with Python’s built-in logging module
• 📘 Standardized log formats across WARP management functions
• 🧹 Cleaned up unused code paths, improving readability and reliability
• ⚙️ Better error visibility, structured logging, and easier debugging

2.4.7

🎉 Release 2.4.7 – WARP Installer Refactor & Config Improvements

Released: 2025-11-21

🔁 Refactor

• 🐍 Refactor(WARP): Replaced the old bash-based WARP installer with a clean, robust Python installer script, improving maintainability, cross-platform compatibility, and readability. 🚀🐍

⚙️ Configuration Enhancements

• 🛡️ fix(config): Added default domain resolver to the Singbox 1.14 routing configuration for improved DNS reliability and smoother routing.
  👉 Contribution by @SeyedHashtag 💡🙌

---

📦 Dependency Updates

Dependencies were updated to ensure better performance, security, and compatibility:

• 📦 Bumped click → 8.3.1
• 📦 Bumped fastapi → 0.121.2
• 📦 Bumped pymongo → 4.15.4
• 📦 Bumped pydantic-settings → 2.12.0
• 📦 Bumped hypercorn → 0.18.0

🙌 Special Thanks

💙 Special appreciation to @SeyedHashtag for contributing the DNS resolver configuration fix and supporting cleaner routing setups.

2.4.6

🌟 [2.4.6] – Server-Side User Search & UI Improvements

Released: 2025-11-09

✨ New Features

• 🔍 Server-Side Search: Implemented backend search for users, improving performance for large user lists.
• 👤 Default On-Hold Status: New users are now created with On-hold status by default.

🐞 Fixes

• ⛔ CLI Fix: Prevent unintended creation_date from being set in add_user command.
• 🧩 Web Fix: Hide expiration days for users with On-hold status in the edit modal for clarity.

2.4.5

🚀 [2.4.5] – IP Limiter Management & Cleanup Improvements

Released: 2025-11-07

✨ New Features

• Web UI: Added “Clean IP Limiter” button to the settings page for easy management.
• API: Introduced /api/limit/clean endpoint to reset the IP limiter state remotely.
• CLI: Added clean command to manage IP limiter directly from the terminal.

🧠 Core Enhancements

• Implemented backend logic to fully reset and clean the IP limiter database.
• Improved tracking and state handling for user IP connections.

🐞 Fixes

• Fixed issue where resetting a user didn’t properly clear usage fields.
• Ensured all disconnected users have their IPs removed from the limiter state.

2.4.4

🚑 [2.4.4] – Traffic System Hotfix & Stability Improvements

Released: 2025-11-06

🐞 Bug Fixes

• Fixed incorrect user online status caused by outdated online_count logic.
• Synchronized database state with live Hysteria2 API data for accurate user tracking.
• Prevented false offline/online display in the web panel and Telegram bot.

🧠 Core Refactor

• Rebuilt traffic.py into an object-oriented design using a new TrafficManager class.

• Improved modularity and maintainability with clear separation for:

  • API interaction
  • Database updates
  • Traffic calculation
  • Expired user handling

🧩 Compatibility & Reliability

• Reintroduced stable public methods (traffic_status() & kick_expired_users()) for CLI and API use.
• Replaced scattered print statements with structured logging.
• Added constants for better maintainability and consistency.

2.4.3

🚀 [2.4.3] – Password Editing, Telegram Enhancements & Stability Fixes

Released: 2025-11-06

🔐 Security & UI Improvements

• Client-Side Password Validation – Prevent weak or invalid passwords directly from the browser.
• Editable Password Field – Users’ passwords can now be securely updated via the user modal.

🤖 Telegram Bot Upgrades

• Added inline keyboard support for clearing user notes.
• Enhanced user detail display, showing notes and improved formatting for admins.

⚙️ Backend & Server Enhancements

• Database-based Online Tracking: Online user count now directly pulled from MongoDB instead of memory.
• Fixed traffic bug causing incorrect offline user status in multi-node environments.

🧹 Maintenance & Dependencies

• Cleaned up requirements.txt to include only top-level dependencies.

• Dependency upgrades:

  • ⬆️ psutil → 7.1.3
  • ⬆️ certbot → 5.1.0
  • ⬆️ python-dotenv → 1.2.1
  • ⬆️ fastapi → 0.121.0
  • ⬆️ aiohttp → 3.13.2
  • ⬆️ idna → 3.11
  • ⬆️ click → 8.3.0