Clash Verge Rev 2.3.0
Version: v2.3.0
Codename: 御 ("Yu")
Meaning: "Yu" symbolizes mastery and guardianship, representing comprehensive improvements in stability, security, and user experience in this release.
⚠️ Known Issues
- Linux: Only briefly tested under Ubuntu 22.04/24.04 and Fedora 41 with the GNOME desktop; compatibility with other distributions is not guaranteed.
- macOS:
- After successful auto-upgrade, please wait 30 seconds before restarting the app to ensure kernel communication recovery due to macOS port-release behavior.
- Tray icon may flicker in dark mode; colored icons appear desaturated.
- Window size and position memory feature removed due to upstream issue in the window state manager.
🐞 Bug Fixes
- Fixed crash when switching "Proxy Mode" on the homepage.
- Fixed failure to enable lightweight mode via macOS shortcut to close window.
- Fixed abnormal window creation/closure on silent startup.
- Fixed incorrect registration of Ctrl+Q global hotkey on Windows.
- Fixed decoding error for VLESS URL and unlock test messages.
- Fixed proxy state issue after switching custom proxy address.
- Fixed invalid default network interface for macOS TUN.
- Fixed tray UI not syncing after subscription changes.
- Fixed TUN mode not enabling immediately after installing service mode.
- Fixed failure to delete
.window-state.json
. - Fixed inability to modify configuration update HTTP timeout.
- Fixed
getDelayFix
hook exception. - Fixed homepage proxy group not displaying when overwritten by external scripts.
- Fixed diagnostic export not syncing with settings page.
- Fixed settings page failing to load after language switch.
- Fixed hyphen handling in the configuration editor.
- Fixed privilege escalation vulnerability by switching to authenticated IPC.
- Fixed failure of lightweight mode in silent startup.
- Fixed JavaScript escape character handling error.
- Fixed Dock icon being launched during macOS silent startup.
- Fixed other known crashes and performance issues.
✨ New Features
- Mihomo (Meta) core updated to v1.19.10.
- Support setting proxy address to non-127.0.0.1 (enhances WSL compatibility).
- System Proxy Guard: Detects and recovers from unexpected changes.
- Tray now displays current lightweight mode status.
- Automatically disconnects active connections when system proxy is turned off.
- New WebDAV Features:
- UA header support.
- Directory redirection support.
- Backup directory checking and upload retry mechanism.
- Automatic Subscription Update:
- Timeout mechanism to prevent freezing.
- Supports retries in proxy mode.
- Clickable subscription cards to change next update time and display result prompts.
- DNS settings now support
hosts
configuration. - Home page proxy nodes can now be sorted.
- Support manual service mode uninstallation, fallback to sidecar mode.
- Core status management: switch, upgrade, and restart supported.
external-controller secret
now auto-completed during config loading.- Added log auto-cleanup options (including 1-day cycle).
- New Zashboard one-click entry added.
- Uses system default window manager.
🚀 Improvements
System
- Improved system proxy bypass settings.
- Enhanced proxy update logic and guard mechanism.
- Windows startup method changed to use Startup folder (improves compatibility with administrator mode).
Performance & Stability
- Asynchronous handling of config loading, UI startup, and event notifications to eliminate lag.
- Optimized MihomoManager and window creation logic.
- Changed core log level to
warn
to reduce noise. - Refactored main process and notification system for better responsiveness.
- Improved network request handling and error feedback.
- Added network resource manager to prevent UI freezing from resource conflicts.
- Memory optimizations for config loading and Mihomo proxy/provider caching.
UI & UX
- Rules page auto-refreshes when switched.
- Editing inactive subscriptions no longer triggers reload.
- Improved tray speed display (disabled by default on macOS).
- Renamed Windows shortcut to "Clash Verge".
- Fallback to proxy mode on update failure.
- Asynchronous port detection and saving with support for random generation.
- Port detection range updated to 1111–65536.
- Smoothed save function to reduce freezing.
Configuration & Security
- Auto-fill
secret
field withset-your-secret
if missing. - Enforced
external-controller-cors
in Mihomo configs (local access only by default). - Improved window permission and state initialization logic.
- Switched delay test to
https://cp.cloudflare.com/generate_204
. - Added deduplication and polling detection in IP information retrieval.
- Improved translation consistency and multilingual UX.
- Enhanced page stability after language switching.
🗑️ Removed
- Window state manager (due to upstream bugs).
- WebDAV cross-platform restore limitations removed.