3.0.0
tobychui/zoraxy3.0.0Feb 18, 2024by tobychui
AI Summary
Zoraxy v3.0.0 represents a major rewrite of the proxy core designed to handle more real-life use cases, introducing comprehensive host routing improvements including wildcard domain support and per-host virtual directories. This release requires a fresh installation as it is not backward compatible with v2 configurations or backups.
Key Highlights
- Complete rewrite of proxy core logic with generalized routing structures
- Introduction of per-host virtual directories and wildcard hostname support (*.example.com) with best-fit matching
- Replacement of 'Proxy Root' with new 'Default Site' featuring redirect and 404 page options
- Enhanced TLS/SSL capabilities including automatic SNI certificate selection and one-click force renewal
- Major UI/UX improvements with optimized menus and less depressing color schemes
Breaking Changes
- Zoraxy v3 host rules are incompatible with v2 - fresh installation required
- Backup & Restore feature is not compatible with v2 configurations
- Deprecated aroz subservice support
- Certificate store renamed from .crt to .pem format
New Features
- Virtual directories integrated into host routing objects (each host maintains its own set)
- Wildcard hostname support with best-fit selection routing (*.a.example.com priority over *.example.com)
- Default Site configuration replacing Proxy Root with redirect and custom 404 page options
- Automatic certificate picking for multi-host certificates (SNI support)
- One-click force renew button for TLS certificates
- New debugging headers: x-proxy-by and X-real-Ip
- Development Mode toggle (Cache-Control: no-store)
- Custom header configuration support
- Separated Virtual Directory edit menu and whitelist comments
- Add controller as member feature for Global Area Network editor
- Uptime monitor timeout optimized from 90 to 10 seconds
Full Release Notes

## Updates v3.0.0
This is a big rewrite of the original Zoraxy v2 proxy core for covering more real-life use cases based on feedback from issues.
**IMPORTANT NOTES**
Zoraxy v3 host rules are not compatible with v2, which the "Backup & Restore" feature is also not compatible. Please start a new installation from scratch if you are currently using Zoraxy v2.
- Restructure the proxy core logic
- Added virtual directory into host routing object (each host now got its own sets of virtual directories)
- Added support for wildcard host names (e.g. *.example.com)
- Added best-fit selection for wildcard matching rules (e.g. *.a.example.com > *.example.com in routing)
- Generalized root and hosts routing struct (no more conversion between runtime & save record object
- Added "Default Site" to replace "Proxy Root" interface
- Added Redirect & 404 page for "Default Site"
- Optimized UI and UX
- Optimized & Separated Virtual Directory edit menu
- Added more less depressing colors
- Added comments for whitelist
- TLS / SSL
- Added automatic cert pick for multi-host certs (it is called SNI btw)
- Added "one click force renew" button
- Renamed .crt to .pem for cert store
- Headers
- Added x-proxy-by header to help with debugging
- Added X-real-Ip header
- Added Development Mode Toggle (Cache-Control: no-store)
- Added custom header
- Others
- Updated up time monitor timeout to 10 seconds instead of 90
- Added "Add controller as member" feature to Global Area Network editor
- Deprecated aroz subservice support
More Screenshots



