This article addresses the issue of subscription links failing to update. When clients such as Clash, V2Ray, and sing-box report an update failure, timeout, blank subscription, or inability to download a configuration, the nodes themselves aren’t necessarily down. The problem is often related to access to the subscription URL, your IP environment, DNS resolution, or browser/system proxy settings. Follow the steps below to troubleshoot in an order that works for most users.
1. First, check whether the subscription link is accessible
Copy the subscription link, but don’t keep clicking Update in your client just yet. Open a new browser tab and paste the link to see what happens. If a block of configuration text appears or a file downloads automatically, the link is probably working. If you see a 404 or 403 error, a blank page, or a page that keeps loading, continue troubleshooting your network environment.
- Make sure you copied the entire link, especially any parameters, tokens, or equals signs at the end.
- Don’t confuse a subscription link with an individual node link. For example, vmess:// and vless:// links are usually for individual nodes, not subscriptions.
- If the subscription is from this site’s free nodes page, return to the original page and copy the latest link to avoid using an expired cached one.
Tip: When a subscription update fails, checking the link in a browser is a more straightforward way to verify it than relying on the client alone.
2. Check your IP environment: your current network may be restricted
Some subscription URLs may fail to load because of suspicious access patterns, frequent refreshes, data center IPs, or networks in certain regions. Try switching networks—for example, switch from Wi-Fi to mobile data, or from a work or campus network to your home network. If the subscription updates after you switch, the issue is likely with your current IP or network gateway.
If you’re already using a proxy when updating the subscription, try both of these options: turn off the proxy and update directly; if that doesn’t work, turn on “Global Mode” and try again. Different subscription sources may require different access routes, so don’t keep retrying with the same network settings.
3. DNS issues can also prevent updates
Accessing a subscription link depends on domain name resolution. If DNS is being tampered with, the cache is incorrect, or your ISP’s DNS is having problems, the client may report a timeout, connection refused, or network error. Here’s what you can try:
- Restart your router and computer or phone to clear some network cache.
- Temporarily change the DNS server in your system’s network settings, for example, to a well-known public DNS server.
- Close and reopen the client, then try updating the subscription again.
- If Clash or sing-box has DNS-related options, leave them at their defaults for now. Avoid enabling several complex rules at once.
Note: DNS issues can make the browser unable to open the subscription domain even while other websites work normally. There’s no contradiction.
4. Make sure your browser, system proxy, and client settings are consistent
Sometimes the subscription opens in your browser but the client can’t update it because the browser is using a proxy and the client isn’t—or the other way around, the client is incorrectly routed through an unusable proxy. In the client’s configuration or settings, check options such as “Use proxy for subscription updates,” “System proxy,” and “Global/Rule mode.”
Try these steps in order: first, turn off the system proxy and try updating; if that fails, turn it on and switch to Global Mode; if it still fails, restart the client and your device. Windows users can also check that the system time is correct, since a large time discrepancy can cause HTTPS certificate verification to fail.
5. What to do if the update still fails
If you’ve tried everything above, copy the subscription link into your browser and download the configuration file, then select “Import from file” in your client. You can also delete the existing configuration and add the subscription again to rule out a corrupted cache. If only one subscription fails to update while others work normally, that subscription source is probably temporarily unavailable or the link has expired.
In summary, if a subscription link won’t update, first check that the link is correct, then check your IP and network, DNS resolution, and whether your browser and client are using consistent proxy settings. Following these steps in order will usually help you identify the cause, without having to reinstall the client right away.