This guide addresses the common issue of subscription links failing to update. In clients such as Clash, V2RayN, and sing-box, you may click to update a subscription only to see it fail, spin indefinitely, show a network error, or download an empty file. In most cases, the nodes themselves aren’t the problem. Your current IP, DNS, or browser/system network environment may be preventing access to the subscription URL. Follow the steps below to troubleshoot.
1. First, check whether the subscription link is accessible
Updating a subscription essentially means the client accesses a URL and downloads a configuration file, so first check whether the link still opens.
- Copy the subscription link, making sure not to include any extra spaces or line breaks.
- Open it in your browser and check whether you see configuration text or a file download starts automatically.
- If you see a 404 or 403 error, or a message that the link has expired or you don’t have permission, the subscription link may no longer be valid and you’ll need to get a new one.
- If it opens in your browser but won’t update in the client, the issue is most likely with the client’s proxy mode or DNS.
If you use the free node subscriptions provided on this site, we also recommend refreshing the page to get the latest link before importing it into your client. This helps avoid using an outdated cached link.
2. Check your IP and network: if direct access fails, try using a proxy
Some subscription servers may be unreliable on certain networks, in certain regions, or with certain carriers. You may find that the link won’t open in your browser, the client times out during an update, or the connection is reset. In this case, try switching networks.
- Switch from Wi-Fi to your phone’s hotspot, or vice versa.
- Connect to a working node in your client, then update the subscription.
- Clash users can try enabling “System Proxy” before updating.
- If you’re using a company or campus network, access may be restricted by its gateway. Try a personal network instead.
Note: Don’t keep clicking Update in quick succession. Some subscription providers may treat frequent requests as suspicious. It’s more reliable to wait a few minutes before trying again.
3. How to fix subscription update failures caused by DNS
DNS resolution problems can cause the subscription domain to point to the wrong address. Common error messages include host not found, lookup failed, and i/o timeout. Try switching to a reliable DNS server and clearing the cache.
- On Windows, change your DNS settings in Network Adapter settings to 1.1.1.1 or 8.8.8.8.
- On Android/iOS, manually enter a public DNS server in the settings for your current Wi-Fi network.
- Clash Meta and sing-box users can check whether the client’s built-in DNS is disabled or misconfigured.
- Restart the client after making changes. If needed, restart your router or phone as well.
If you’ve enabled “Enhanced Mode” or “TUN Mode,” it may also affect DNS routing. You can temporarily turn off TUN, update the subscription, and then restore your original settings.
4. Check your browser environment and client cache
Sometimes a subscription opens in your browser but still fails in the client. This may be caused by the proxy port, cached data, or certificate settings. Try these steps in order:
- Make sure your system clock is correct. An incorrect time can cause HTTPS certificate validation to fail.
- Temporarily disable antivirus software, packet capture tools, and ad-blocking extensions, then try again.
- Delete the old subscription from your client and add the full link again.
- Make sure the link starts with http or https; don’t paste only the latter part.
- Update your client to a newer version. Older versions may not support some subscription formats.
Clash users should also check the error messages in the logs: 403/401 usually indicates a link permissions issue; timeout usually points to a network or DNS problem; and yaml parse error may mean the subscription content uses an incompatible format.
5. A quick way to diagnose persistent update failures
Here’s a simple rule of thumb: if the link won’t open in either your browser or client, it’s likely invalid or inaccessible from your current network. If it opens in your browser but not in the client, the problem is more likely related to the client’s proxy, DNS, or cache. If switching networks fixes the issue, your original network is probably restricting access.
Recommended troubleshooting order: copy the subscription link again → switch networks/IPs → change DNS → clear the client’s subscription cache → check the logs. Following these steps will usually help you identify why your subscription link won’t update and get updates working again.