On this page
First confirm that this is the same type of shutdown block
This article addresses one specific symptom: when Clash Verge Rev remains running, Windows shutdown or restart stops at the “This app is preventing shutdown” screen. After canceling shutdown, the client may show a blank window or fail to exit normally, while fully exiting it from the system tray before shutdown restores normal behavior.
Official repository issues #7725, #7755, #7794, and #7841 contain multiple similar reports covering Windows 10, Windows 11, stable v2.5.2, and later AutoBuilds. Some reports still reproduce after TUN and system proxy are disabled, so turning off TUN alone does not prove that Service has exited.
First confirm that Clash Verge Service is installed, Running Mode in the diagnostics shows Service, the app remains in the tray after the main window is closed, and shutdown is blocked only while the app is running. This article does not apply when the blocker is an unsaved document, Windows Update, another VPN, or a differently named background process.
Use four signals to define the scope
| Check | Behavior that matches this article | If it does not match |
|---|---|---|
| When it happens | Shutdown or restart is blocked while Clash Verge Rev remains running | First confirm the actual blocking process shown by Windows |
| Runtime mode | Clash Verge Service is installed and Running Mode is Service | Troubleshoot it as an ordinary non-Service exit failure |
| TUN and system proxy | It may still reproduce after both are disabled | If disabling them resolves it, address TUN or leftover proxy settings first |
| Full-exit comparison | Shutdown works after choosing Exit from the tray | If both states are blocked, continue checking other applications |
Run two reversible comparison tests before inspecting the Service
For the first test, leave Clash Verge Rev running, save all work, and restart once. If the blocking screen appears, cancel the restart instead of choosing “Shut down anyway,” and note the time.
For the second test, choose “Exit” from the system tray instead of only clicking the window's Close button. Wait for the tray icon to disappear, confirm in Task Manager that the Clash Verge Rev GUI has ended, and then perform the same restart.
Inspect the Service only if you can consistently reproduce the difference between “blocked while running” and “normal after a full exit.” If both tests are blocked, use the Windows prompt and Task Manager to identify the actual blocking process first.
Complete the minimal comparison
Save your work and record the environment
Record the Windows version, Clash Verge Rev version, Running Mode, and current Profile without exposing the subscription URL or token.
Test once with the app running
Perform a controlled restart. If the blocking screen appears, cancel it and save the logs for that time.
Quit completely from the tray
Confirm that both the tray icon and GUI process disappear; do not treat closing the main window as exiting.
Repeat the test with the same steps
Restart again and compare only the exit method. Do not change TUN, the Service, and the version at the same time.
Determine whether shutdown stalls at Service IPC
After canceling shutdown, open the latest application log and read from the exit phase onward. Similar reports first save the configuration, disable TUN, and stop the core, then stall at “Stopping core through service (IPC).”
If the log never reaches “Service successfully stopped the core,” cleanup completion, or Application exited, while a manual tray exit records those completion messages normally, you can narrow the fault boundary to the Service stop request or its completion wait during the system shutdown path.
The reporter in issue #7794 used process dumps to conclude that the Service had returned to an idle state while the client-side IPC completion wait never returned. This is useful diagnostic evidence, but it is not an official root-cause conclusion from the maintainers.
[Core] Stopping service
[Service] 通过服务停止核心 (IPC)The log stalls at Service IPC, but a manual exit records Application exited
Prefer a full exit and evaluate temporarily leaving Service Mode.
The log ends before TUN is disabled
Repeat the test and collect a complete log instead of attributing it directly to Service IPC.
Clash Verge Service is not installed
The Service steps in this article do not apply; inspect the ordinary GUI or other blocking processes.
Windows still has no connectivity after exit
Restore the system proxy settings and direct connectivity before the next shutdown test.
Restore direct connectivity and preserve your configuration before making changes
Before disabling the Service or changing versions, record the current version, Running Mode, subscription name, active Profile, and whether the system proxy and TUN are enabled. Turn off TUN and the system proxy, confirm Windows can reach the LAN or basic network without relying on a local proxy port, and then fully exit from the tray.
Do not delete the AppData configuration directory or publicly upload complete logs containing subscriptions, node passwords, controller secrets, or tokens. If you need to submit a dump, understand first that process memory may contain sensitive information.
Reversible baseline
- The source and version of the current stable installer are recorded
- Profile, overrides, and subscription names are saved
- TUN and the system proxy are both disabled
- Direct Windows connectivity and LAN access are verified
- The tray icon is gone and the GUI has fully exited
- Logs or screenshots have been redacted
Low-risk workaround: fully exit the GUI before shutdown
The lowest-risk temporary workaround is to choose “Exit” from the system tray before shutdown or restart, wait for the GUI, Mihomo core, and cleanup process to finish, and only then shut down Windows. Closing the main window usually only hides the app in the tray and does not prove that exit is complete.
This step does not modify the configuration, uninstall the Service, or change subscriptions. Start Clash Verge Rev normally after the next boot to restore operation. It is the best default workaround while the issue is still awaiting an official fix.
Full-exit verification criteria
- The tray icon has disappeared
- Clash Verge Rev GUI no longer appears in Task Manager
- The log records a successful Service stop and Application exited
- Windows no longer says Clash Verge Rev is preventing shutdown
Medium-risk workaround: temporarily leave Service Mode
If manually exiting before every shutdown is impractical, you can temporarily leave Service Mode. First disable TUN and the system proxy and confirm normal network access, then use the Service Mode control in the current client settings to disable or uninstall Clash Verge Service. Button labels can differ between builds, so prefer the in-app control.
Do not directly delete Windows service registry entries, virtual network adapters, or service files in the installation directory. Restart Windows after uninstalling, then open the client and confirm that Running Mode has returned to Sidecar or another non-Service state.
Verify basic connectivity with the system proxy alone first. TUN may be unavailable without the Service or administrator privileges; this is an expected tradeoff and should not be bypassed by repeatedly toggling TUN.
Leave Service Mode safely
Restore direct Windows connectivity
Disable TUN and the system proxy, and confirm that traffic no longer points to a local proxy port.
Fully exit the client
Exit from the tray and wait for cleanup to complete before opening the Service Mode control in Settings.
Disable or uninstall through the app
Accept the normal UAC prompt; do not manually delete service registrations or unfamiliar files.
Test the system proxy first after restart
Confirm that Running Mode is no longer Service, keep TUN off, and complete one real HTTPS request.
Higher-risk workaround: roll back to v2.5.1 only with a controlled comparison
Reporters in issues #7725 and #7794 identified v2.5.1 as the last working version on their own devices, but this is not a general rollback guarantee from the maintainers. Consider a controlled comparison with the official v2.5.1 Release only after reproducing the same log boundary, confirming that a full exit resolves it, testing with the Service disabled, and establishing that you genuinely need Service Mode.
Before rolling back, keep the current stable installer, record the version and configuration, and download v2.5.1 for the correct device architecture from the project's official Release. Do not delete user configuration. On first launch, keep TUN and the Service off, confirm the subscription and system proxy work, then install the Service and change only that one variable for the shutdown test.
Older versions lack later fixes and should not be used long term. If v2.5.1 still blocks shutdown, stop treating the version as the cause. Reinstall the current stable v2.5.2 or a later stable release that officially confirms a fix, and initially leave the Service uninstalled.
How to interpret the version comparison
| Result | Conclusion and next step |
|---|---|
| v2.5.1 restarts normally twice in a row | This only confirms the comparison on this computer; preserve the evidence and monitor later stable releases |
| v2.5.1 still blocks shutdown | Stop downgrading, restore the current stable release, and leave the Service uninstalled |
| Subscription or network problems appear after rollback | Restore the current stable release and direct connectivity first; do not continue mixed testing |
| Only an old installer from an unknown source is available | Do not roll back; use a full exit or disable the Service instead |
These workarounds are not a fix
Do not repeatedly choose “Shut down anyway” or hold the power button. Do not delete the entire AppData configuration directory, manually remove unknown Windows services or virtual adapters, or download an AutoBuild from an unverified source for testing.
Force-ending a process can clear one block, but it may skip configuration saving and proxy cleanup. Use Task Manager to end the GUI only as a last resort to recover the current desktop after canceling shutdown, saving all work, and confirming that the client cannot exit on its own. Check the system proxy afterward.
Verify shutdown, restart, and proxy recovery
After choosing one workaround, complete two consecutive restarts at a controlled time. Save your work before each test, record whether the blocking screen appears, and check the system proxy, subscription, Profile, and rules after signing in again.
An unblocked shutdown is only the first result. Also confirm that the log completes the core stop before exit, Windows has no leftover proxy after restart, the configuration remains intact after reopening the client, and the system proxy can complete a new HTTPS request.
Final validation checklist
- The comparison between leaving the app running and fully exiting from the tray is recorded
- The Windows version, Clash Verge Rev version, and Running Mode are recorded
- Whether the log stalls at “Stopping core through service (IPC)” has been confirmed
- Each test changes only one of the exit method, Service state, or version
- Two consecutive shutdowns or restarts complete without an app-blocking screen
- No Windows system proxy remains and direct connectivity can be restored
- Subscriptions, Profiles, and rules remain intact after reopening the client
- If the Service was uninstalled, TUN is no longer mistakenly treated as available
- If the version was rolled back, the installer and path for returning to the current stable release have been preserved
What the current evidence does and does not show
As of 2026-09-01, the available evidence shows that Clash Verge Rev blocking Windows shutdown is not an isolated user report. The behavior has been reported multiple times when Service Mode is active and the GUI remains running, and an official collaborator also reproduced it in issue #7755.
However, it would be inaccurate to say that “Service IPC has been officially confirmed as the sole root cause.” Issue #7725 was closed after a maintainer requested retesting following the Service refactor; it was not an official fix announcement. Issue #7794 later reported that a post-refactor AutoBuild still reproduced the problem, and #7841 recorded the same behavior with v2.5.2 on Windows 10.
Stable release notes have not yet announced a fix. A follow-up report should include redacted logs, the version, Running Mode, a manual-exit comparison, and whether the Service is installed. Do not publish full process dumps, subscriptions, or node credentials.
References
- Clash Verge RevReproduction and logs of Windows shutdown waiting for Service IPC to stop the core
- Clash Verge RevCollaborator reproduction of the retained UI blocking shutdown in Service Mode
- Clash Verge RevSession-ending IPC wait that persists after the Service refactor
- Clash Verge RevRecent reproduction of v2.5.2 blocking Windows shutdown
- Clash Verge RevClash Verge Rev v2.5.2 stable release
- Clash Verge RevClash Verge Rev v2.5.1 stable release
