A VPN that worked yesterday can stop connecting immediately after an app, operating system, or configuration update. The failure may look like a server problem, but updates can also reset permissions, replace a protocol preference, disable background access, remove an imported subscription, or leave incompatible data in the app cache. The fastest solution is not to change every setting at once. It is to identify which layer changed and test one layer at a time.
This guide focuses on practical recovery steps for Windows, macOS, Android, iOS, and Linux clients, as well as compatible tools such as Clash Verge, sing-box, and Shadowrocket. The same order also applies when a subscription was imported through a link. Start with the application state, then check the subscription, permissions, protocol, DNS behavior, and local network. Keeping this order makes it easier to undo a change and recognize the actual cause.
Identify the failure layer first
“The VPN is not working” can describe several different situations. The client may fail to start, the tunnel may connect but have no usable traffic, only one application may bypass the proxy, or the connection may work briefly and then stop. These cases require different fixes. If the client interface shows “connected” but an IP-check page still shows the local network, the problem is probably traffic coverage or routing rather than authentication. If every server fails during the handshake, permissions, subscription validity, protocol compatibility, or the local network become more likely.
5
Supported platforms
90+
Countries covered
200+
Routes available
Unlimited
Online devices
Use a simple comparison test before reinstalling anything. First, open an ordinary website without the VPN. Next, connect to a different server in the same client. Then open the IP Check page in the same browser or application that you are testing. Finally, try the client on another supported device if one is available. These tests help separate a service-wide issue from a device-specific update problem without relying on assumptions about the route name.
| What you observe | Most likely area | First action |
|---|---|---|
| The app will not open or closes immediately | Installation, permissions, or system compatibility | Restart the device and check the app version and system permissions |
| The app connects but websites use the local IP | Proxy mode, split tunneling, or application coverage | Enable the intended system or global mode and test again |
| Every server fails during connection | Subscription, protocol, time, or network filtering | Refresh the subscription and test another protocol |
| Only one website or app fails | Application cache, DNS, account session, or routing rule | Test a clean browser session and inspect the matching rule |
Refresh the app and subscription safely
An update can preserve an old cache while changing the way configuration files are parsed. This is common when a client changes its internal format, renames a setting, or updates its network permission model. Start with the least destructive actions: close the client completely, restart the device, reopen the client, and check whether the imported profile is still present. On desktop systems, closing the window may not stop the background service, so use the client’s quit or exit command before reopening it.
Next, inspect the profile or subscription entry. Confirm that it is enabled, that the last refresh did not return an error, and that the profile still contains servers. A subscription link and a downloaded configuration file are not identical: the link can retrieve updated server information, while a local file remains unchanged until you import a new version. If the client provides a refresh button, refresh the existing entry instead of creating many duplicate profiles.
If the subscription refresh fails, test the link in the client’s built-in import field or copy it again from the account panel. Avoid editing the link with a text editor because an omitted character, an extra space, or a line break can make the request invalid. If the link includes credentials, treat it as private and do not post it in a public support channel. When the account panel is accessible, sign in again only after checking whether the current profile can be exported or copied.
Clear stale state without losing settings
Clear temporary cache only after confirming that the profile can be imported again. Some clients store logs, DNS results, certificate information, and interface state separately from the actual subscription. Clearing only temporary data may solve a startup or handshake problem while preserving the profile. Other clients place everything in one local directory, so deleting application data may remove custom rules, proxies, and routing preferences.
On Windows and macOS, look for the client’s own reset, repair, or logout option before manually deleting folders. On Android, the difference between “clear cache” and “clear storage” matters: the latter can remove local configuration. On iOS, removing and reinstalling an application can also remove locally stored profiles, so make sure the subscription link or configuration backup is available first. On Linux, check whether the client is managed by a desktop service, a system service, or a command-line process; restarting the wrong component may leave the old process running.
- ✅ Keep the subscription link or configuration backup before resetting local data
- ✅ Refresh the existing profile before importing several duplicate copies
- ✅ Close the client completely so an old background process does not retain stale settings
- ❌ Do not share a private subscription link in screenshots, forums, or public tickets
- ❌ Do not delete all configuration files before confirming that the profile can be restored
Check permissions, protocols, and routing
Operating system updates can revoke or re-confirm permission for a VPN tunnel. Windows may show a new network adapter prompt, macOS may require approval for a network extension, Android may ask to create a VPN connection again, and iOS may display a system permission request after reinstalling or changing the client. If the permission was denied, the application can remain open while every connection attempt fails. Open the operating system’s network or VPN settings and confirm that the current client is allowed to create and maintain its tunnel.
Also check whether battery saving, background restrictions, or security software is stopping the client. Mobile systems may suspend a client when the screen is off. Desktop security tools can block a newly updated executable until it is trusted again. Do not disable all security controls as a first response. Instead, check the system notification, firewall rule, or permission list and allow only the official client or its required network extension.
Protocol selection is the next useful test. Shadowsocks is commonly used as an encrypted proxy transport, while VMess and Trojan are proxy protocols with different authentication and transport arrangements. Hysteria2 is designed around QUIC and UDP behavior, so it may react differently from TCP-based options on restrictive or unstable networks. WireGuard is a VPN protocol with its own key and tunnel configuration; it should not be treated as a generic subscription format. A client may support several of these protocols, but support depends on the imported profile and the application.
After an update, a previously selected protocol may no longer be compatible with the current profile, or a new default may behave poorly on the present network. Change only one protocol or transport option at a time. Test a normal website after each change, and return to the previous choice if the result becomes worse. Do not combine a protocol change, DNS override, custom rule set, and new profile import in one attempt because the outcome will be difficult to interpret.
Routing mode is equally important. A rule-based mode may send some domains through the proxy and leave local services direct. Global or system-wide modes generally cover more traffic, but they can also affect software that expects a direct connection. In Clash Verge and sing-box, inspect the active mode, rule set, and matching policy group. In Shadowrocket, verify that the selected global, configuration, or rule-based mode matches the traffic you are testing. A browser extension proxy can work independently from a system tunnel, so do not assume that an application is covered merely because the client shows connected.
Repair DNS, network, and session problems
DNS problems often look like a failed VPN connection. The tunnel may be established, but domain names do not resolve, resolve slowly, or resolve through a path that does not match the selected route. Compare a domain-based test with an IP-based test only as a diagnostic exercise; most normal applications still need reliable DNS. If changing the DNS option inside the client makes no difference, restart the client and the device before adding manual system DNS settings.
Check for conflicts with other network tools. Running two VPN clients, a separate proxy application, a browser proxy extension, a local DNS filter, or a corporate security agent at the same time can create competing routes. Disable one competing tool temporarily, restart the active client, and test again. On desktop systems, an old virtual adapter can also remain after an incomplete uninstall. Use the operating system’s network adapter list to identify inactive or duplicate entries, but avoid deleting adapters without knowing which application created them.
The local network may also be responsible. Try a different connection such as mobile data or another trusted Wi-Fi network. If the VPN works there, the original network may block a transport, intercept DNS, require captive-portal sign-in, or impose a firewall policy. Complete any hotel, school, office, or public Wi-Fi login before starting the tunnel. When a network changes, restart the client rather than repeatedly clicking connect; the old route, gateway, or DNS state may still be held by the process.
Session issues are worth checking when the connection works but a particular service keeps redirecting, logging out, or showing stale content. Open a private browser window, sign in again only when necessary, and remove the site’s old session data if the behavior continues. Keep the exit region stable during the test instead of switching routes repeatedly. A VPN changes the network exit, but it does not change an account’s eligibility, payment region, application policy, or identity checks. Follow the destination service’s official terms and supported-region rules.
Time and certificate errors should not be ignored. If the system clock is significantly wrong, encrypted connections and certificate validation may fail even when the network is available. Set the device to use automatic date and time, then restart the client. Also check whether the operating system, client, and security software are current enough to support the selected configuration. An update may fix one compatibility problem while exposing an older operating-system limitation, so record the exact versions when contacting support.
Know when to reinstall or contact support
Reinstalling is appropriate when the client cannot start, its network extension is damaged, the interface repeatedly crashes, or a clean profile works on another device but not on the affected one. Before uninstalling, export custom rules where possible and save the subscription link. Remove the old application through the operating system’s normal process, restart the device, install the official version, and import one known-good profile. Avoid restoring every old setting immediately; first confirm that a clean installation can connect.
For compatible third-party clients, verify that the imported format matches the client. A Clash-compatible configuration is not automatically a native WireGuard profile, and a sing-box JSON file is not interchangeable with every other client format. Shadowrocket, Clash Verge, and sing-box may support overlapping protocols, but their rule syntax, DNS behavior, and subscription converters can differ. If an imported profile is rejected, identify whether the problem is the source format, a converter, a missing field, or the client itself.
Contact support when the profile cannot refresh on multiple devices, every route fails after the account is confirmed, or the same error remains after a clean installation. Provide the platform, client name, app version, operating system, approximate time of the failure, selected protocol, and the exact error text. Do not include passwords, private subscription links, payment credentials, or unrelated personal information. A concise reproduction sequence is more useful than a screenshot that hides the error message.
For users who need to test another platform, VncVPN supports Windows, macOS, iOS, Android, and Linux, with 90+ countries and 200+ routes. The service allows unlimited online devices, so testing the same account on another supported device can help identify whether the issue is local to one installation. Available payment methods include Alipay, WeChat Pay, and USDT; registration requires only a username and password rather than an email address. If the service is not suitable after testing, the published offer includes a 60-day no-questions-asked refund policy. Review the applicable terms before submitting a request.
Do not interpret one failed update as proof that every route or every client is unavailable. Updates can affect one platform while another continues working, and a profile can become incompatible without the underlying account being disabled. Work from the smallest change to the largest: restart, verify the profile, restore permissions, test the protocol, inspect routing and DNS, remove conflicts, and reinstall only when the evidence points to local application damage.