This article addresses the common issue of “what to do when a subscription link won’t update”: whether you use Clash, V2RayN, sing-box, or Shadowrocket, if subscription refresh fails, keeps timing out, or shows a network error, you can troubleshoot step by step below by checking your IP, DNS, browser environment, and client settings.
1. First, confirm that the subscription link itself is accessible
Many update failures are not caused by a broken client, but by the subscription address being temporarily unavailable, copied incompletely, or blocked by the environment. It is recommended to first copy the subscription link into your browser’s address bar and open it. If you can download a block of node content, the link is basically working; if it shows 404, 403, a blank page, or keeps loading forever, you need to continue troubleshooting.
- Make sure the link does not include extra spaces, Chinese punctuation, or line breaks.
- Check whether the subscription link has expired, especially for temporary free node subscriptions.
- Test with a different browser, such as Chrome, Edge, or Safari.
- Turn off browser proxy extensions before opening the subscription address again.
If the free node subscription provided by this site cannot be updated temporarily, it may also be due to high traffic or upstream node adjustments. Trying again later is usually more effective than repeatedly clicking refresh.
2. Your IP environment can affect subscription updates
Subscription links usually need to be accessed directly from your current network. If your local IP is restricted by the target service, your ISP network is abnormal, or the client is in an incorrect proxy state, the update may fail. In this case, try switching networks: change from Wi-Fi to a mobile hotspot, or from a company network to a home network.
The key is to determine whether the problem is with the “link” or the “current network environment.” If the same subscription can update over mobile data but not over broadband, it is most likely related to your current IP, ISP routing, or network filtering. In that case, you can restart your router to obtain a new IP, or try again later.
3. Improper DNS settings can also prevent refreshing
DNS is responsible for resolving the subscription domain name into an IP address. If DNS is polluted, the cache is incorrect, or resolution is too slow, the client will show timeouts or be unable to connect to the server. Regular users can handle it as follows:
- Switch DNS in your system network settings, for example to 1.1.1.1, 8.8.8.8, or 223.5.5.5.
- Restart the client and clear the old subscription cache.
- Restart your router and computer to refresh the local DNS cache.
- In clients such as Clash and sing-box, confirm that incorrect DNS rules are not enabled.
Do not enable multiple proxy tools at the same time. For example, running Clash together with a browser proxy extension may cause the subscription request to be routed around repeatedly and ultimately fail to update.
4. The correct update steps inside the client
Different clients may use slightly different names, but the overall process is the same. Using common clients as examples: first open the configuration or subscription page, delete the old failed subscription, then paste the complete subscription link again and click “Update,” “Refresh,” or “Download Configuration.” If the client supports “updating subscriptions through a proxy,” try both enabling and disabling it to see which works.
Clash users can check whether the Profile page reports an error; V2RayN users can right-click the subscription group and select “Update Subscription”; sing-box GUI clients can view the configuration import log. When you see messages such as TLS, timeout, or lookup failed, they usually correspond to certificate time issues, network timeouts, and DNS resolution problems respectively.
5. Quick checklist if it still fails
- Copy the subscription link into a browser to test whether it opens.
- Switch to a mobile hotspot or another Wi-Fi network and update again.
- Change DNS, then restart the client.
- Disable other proxy software, browser extensions, and security software interception.
- Delete the old subscription and re-import the complete link.
- Check whether the system time is accurate; incorrect time may cause certificate verification to fail.
The most effective troubleshooting order is: whether the link is valid → whether the network/IP is normal → whether DNS resolves correctly → whether the client is misconfigured. Following this order will usually help you identify most “what to do when a subscription link won’t update” issues. If the same link cannot be opened across multiple networks and multiple clients, then the subscription source itself is most likely having issues, and you can only wait for recovery or switch to an available subscription.