This guide explains how to fix subscription links that won’t update. If a client such as Clash, V2Ray, or sing-box can’t fetch a subscription and shows a timeout, a blank page, or a 403/404 error, follow the steps below to check your network, IP, DNS, browser environment, and client cache.
1. First, check whether the subscription link is accessible
Many update failures aren’t caused by a faulty client—the subscription address may simply be temporarily unavailable. Copy the subscription link and paste it into your browser’s address bar rather than opening it directly from a chat app. Normally, it may download a text file or display a long list of node configurations. If you see an access error, connection timeout, or certificate error, the client probably won’t be able to update either.
- Copy the entire subscription link and make sure it contains no extra spaces, line breaks, or Chinese punctuation.
- Open it in an incognito window to avoid interference from old cache data.
- Try a different network, such as switching from Wi-Fi to your phone’s hotspot.
- If this site’s free nodes page offers a new subscription, copy the latest link and import it again.
Important: Don’t rely solely on the “Update failed” message in your client. First check whether the link is accessible in a browser—this is the quickest way to narrow down the cause.
2. How your IP, DNS, and region can affect access
A subscription server may respond differently depending on where the request comes from. For example, access may be restricted from certain public IP addresses, or your ISP’s DNS may fail to resolve the address correctly. First, turn off your proxy and try accessing the link over your local network. If that doesn’t work, connect to a working node and try updating the subscription again. Testing both ways can help you determine whether the failure is caused by a direct connection or the proxy connection.
- IP issues: If requests keep failing over the same broadband connection, try your phone’s hotspot or restart your modem to get a different public IP address.
- DNS issues: If your client’s or system’s DNS is malfunctioning, the domain may not resolve to the correct address. Temporarily switch to a public DNS server and try again.
- Proxy mode issues: Clash may behave differently in Global, Rule, and Direct modes. Try each mode separately.
If the subscription opens in your browser but won’t update in the client, the problem is usually related to the client’s DNS, system proxy, certificate verification, or cached configuration—not a completely invalid subscription.
3. Fixes to try in your client
The options may have slightly different names in different clients, but the approach is the same: refresh the subscription, clear the cache, and then delete and reimport it.
- Go to the subscriptions or configuration page and tap “Update,” “Refresh,” or “Update.”
- If the update fails, check that your system clock is correct. An incorrect time can cause HTTPS certificate verification to fail.
- Close and reopen the client. If necessary, restart your phone or computer.
- Delete the old subscription configuration, then paste in the link again and reimport it.
- Make sure the subscription type is supported—for example, don’t import a Clash subscription through an option that only supports individual node links.
Note: Some clients cache old configurations, so they may keep showing the previous error even after the link is working again. Deleting and reimporting the configuration is often more effective than repeatedly tapping Update.
4. Your browser environment can also affect the results
When you test a subscription link in a browser, extensions, ad blockers, privacy settings, and corporate network security policies may block the download. Try a built-in system browser or an incognito window, and avoid opening the link through webpage translation, short-link redirects, or an in-app browser. On a phone, try copying the original link into a mainstream browser such as Safari, Chrome, or Edge.
Also check whether the link has expired or been reset, or whether your account permissions have changed. If the page shows “unauthorized,” “forbidden,” or “not found,” the link is usually invalid or your permissions are insufficient. You’ll need to get a new subscription address.
5. Quick troubleshooting order
We recommend following these steps in order: first, make sure the link is complete and test it in a browser; then switch networks and DNS; next, delete the old configuration and reimport it in the client; finally, try a different subscription source. If only one node won’t connect but the subscription updates successfully, the issue is with that node’s availability. If none of your configurations can be fetched, focus on the subscription link, IP, DNS, and client environment.
In short, if your subscription link won’t update, don’t rush to reinstall the app. Check the link, network/IP, DNS, client cache, and browser environment in that order to pinpoint the problem.