This article addresses the common issue of “what to do when a subscription link won’t update.” If updating a subscription in clients such as Clash, V2RayN, or sing-box fails with a network error, an empty configuration, or a download error, follow these steps to troubleshoot your IP, DNS, browser environment, and client settings and restore normal imports.
1. First, check whether the subscription link itself is accessible
A failed subscription update doesn’t necessarily mean the nodes are unavailable. Often, the link is blocked by your network environment, DNS resolution is failing, or the client can’t access the subscription URL. Start with the simplest test: copy the subscription link and open it in your browser.
- If your browser downloads a text file or configuration file, the link is likely working, and the issue is probably with the client.
- If your browser says the site can’t be reached, times out, or the connection was reset, check your network, DNS, or proxy settings first.
- If you get a blank page, a 404, or a permissions error, the subscription may have expired or the link may be incomplete. Try obtaining it again.
Make sure you don’t miss any characters at the end of the link, and don’t copy any extra spaces or line breaks. For the free node subscriptions provided on this site, we recommend using the “Copy link” button to avoid errors from selecting the text manually.
2. Check your IP environment: if direct access fails, enable a proxy before updating
Some subscription URLs can’t be accessed directly on certain networks, especially campus networks, corporate networks, public Wi-Fi, and some carrier networks. If your client can’t update the subscription in these cases, that doesn’t mean the subscription is broken.
Try the following:
- Connect to a node that’s still working, then click “Update subscription.”
- In Clash-based clients, try enabling “System Proxy” before updating.
- On mobile, switch between Wi-Fi and mobile data to rule out network restrictions.
- If you’re on a corporate or campus network, try again using your home broadband or mobile data.
The key is to check whether the subscription link opens on any network.If it works after you switch networks, your original IP or network policy is likely restricting access.
3. DNS issues can also cause subscription update failures
DNS translates a subscription domain name into an IP address. DNS poisoning, an incorrect cache, or a timeout can make the client think the link is unavailable. Common symptoms include the link opening intermittently in a browser while the client keeps failing to update, or the same link behaving differently on different devices.
Here’s what you can try:
- Close the client, reconnect to the network, and open the client again.
- Temporarily change your DNS in your system’s network settings, for example, to a commonly used public DNS service.
- Clear your browser cache or try opening the subscription link in a different browser.
- If your router hasn’t been restarted in a while, restart it to refresh its cache.
Don’t keep clicking Update over and over.Some subscription services limit requests made in quick succession, so it’s safer to wait a few minutes before trying again.
4. Check browser and client settings separately
Sometimes a subscription opens in your browser but won’t update in the client. Common causes include the client not using a proxy, an incompatible subscription User-Agent, a corrupted configuration cache, or an outdated version of the software. Try these steps first:
- Update your client to a recent stable release, such as Clash Verge, v2rayN, or the graphical client for sing-box.
- Delete the old subscription and add the link again instead of repeatedly overwriting the existing subscription.
- Check that you’ve selected the right subscription type. For example, don’t import a Clash subscription into a field that only supports standard V2Ray share links.
- Make sure your system clock is correct; a significant time difference can affect HTTPS certificate validation.
If you see a certificate error,the cause is usually an incorrect system time, network interception, or HTTPS scanning by antivirus software. First correct the time and disable any unnecessary network filtering, then try again.
5. Recommended troubleshooting order
If you’re wondering what to do when a subscription link won’t update, follow a consistent troubleshooting order: first test the link in a browser, then switch networks or enable a proxy, check DNS, and finally reinstall or switch clients. This helps you avoid deleting your configuration unnecessarily.
If the same subscription link won’t open on any device or network, it’s likely expired or no longer accessible due to permissions, and you’ll need to obtain a new one. If only one client fails, focus on its cache, version, and import format. Keep a backup of the original subscription link while troubleshooting so you can restore it if you accidentally delete it.