This guide covers common solutions for when a subscription link won’t update: the update fails, times out, or shows a network error in clients such as Clash, V2RayN, and sing-box, or the link opens in a browser but the client can’t update it. Follow the steps below to check your IP, DNS, browser environment, and client settings.
1. First, check whether the subscription link is accessible
A failed update doesn’t necessarily mean the software is broken. First, check whether the link is still valid. Copy the subscription link and paste it into your browser’s address bar. If it returns a large block of text or YAML, or automatically downloads a file, the link is probably accessible. If you see a 404 or 403 error, an expiration notice, or a blank page, the subscription may have expired or the server may be restricting access.
- Make sure you copied the entire link, especially any parameters at the end.
- Check that the link contains no spaces, line breaks, or non-English punctuation.
- If you can’t update a free node subscription from this site, try again later or copy the latest subscription URL.
Note: Don’t confuse node-sharing links with subscription links. Individual vmess/vless/trojan links generally can’t be used as subscription URLs.
2. Check your IP environment: Is access restricted or the network unreachable?
Some subscription URLs restrict access based on IP. Too many requests from the same IP, problems with your ISP’s network, or restrictions on corporate or campus networks may all cause updates to fail. Try switching networks: test mobile data, home broadband, and public Wi-Fi. If the update works on another network, the issue is likely with your current IP or network gateway.
If your client supports “update subscription via proxy,” try enabling it. Some subscription domains can’t be accessed directly from your local network but can be reached through a proxy. Conversely, an unstable proxy connection can also cause update failures; in that case, disable “update subscription via proxy” and try again.
- Clash clients: Check whether the subscription settings include an “Update via proxy” option.
- V2RayN: Try enabling a working node before updating the subscription.
- sing-box GUI clients: Make sure your system proxy and application proxy settings aren’t conflicting.
3. DNS issues: What to do when domain name resolution fails
If your subscription URL starts with a domain name, a DNS resolution error will prevent the connection. Symptoms include slow page loading in a browser and client errors such as timeout, no such host, or connection failed. Try temporarily changing your system DNS to a public DNS server, such as 1.1.1.1, 8.8.8.8, or 223.5.5.5. Then flush the DNS cache and restart the client.
On Windows, open Command Prompt and run ipconfig /flushdns. On macOS, restart your network connection or flush the DNS cache in Terminal. After changing DNS, don’t just click Update once—wait a few dozen seconds before trying again, in case the old DNS result is still cached.
4. The link opens in a browser, but the client update fails
This often happens when the client is outdated, the subscription format is incompatible, certificate verification fails, or the system clock is incorrect. First, make sure your system date and time zone are correct, since HTTPS certificates depend on the system clock. Then update your client to a newer version. Clash Verge, Clash Meta, V2RayN, and sing-box support different subscription formats. If you see a parsing error, the subscription content may not be in a format supported by your client.
Recommended: Delete the old subscription and add it again rather than repeatedly clicking Update on the existing entry. If the software offers a “User-Agent” or “Compatibility mode” option, switch it and try again.
5. Quick troubleshooting checklist
- Paste the subscription link into a browser and confirm that it opens.
- Switch to mobile data or another Wi-Fi network to check for IP or network restrictions.
- Change your DNS settings and clear the system DNS cache.
- Check whether you’ve enabled the wrong proxy update setting.
- Update the client, then delete and reimport the old subscription.
- Make sure the system clock is correct to avoid HTTPS certificate errors.
If none of the above works, note the client’s error message, the name of the software you’re using, and your network environment before continuing to troubleshoot. Subscription update failures usually have more than one possible cause. For the most efficient troubleshooting, check in this order: link validity → IP and network → DNS → client compatibility.