This article addresses the problem of “what to do when a subscription link won’t update”: when clients such as Clash, V2RayN, and sing-box cannot fetch a subscription and show errors like timeout, empty configuration, or 403/404, you can follow the steps below to check the IP, DNS, browser, and client environment, and quickly determine whether the issue is with the network, the link itself, or the local cache.
1. First, confirm that the subscription link itself is working
Many update failures are not caused by a broken client, but because the subscription URL is temporarily inaccessible. First copy the subscription link and paste it into the browser address bar. Under normal circumstances, it should download a text file or display content mainly consisting of node information. If the browser reports that it cannot access the page, shows a certificate error, or returns 404, the client usually will not be able to update either.
- Check whether the link was copied completely, especially make sure the final token parameter is not missing.
- Make sure the link does not contain extra spaces, Chinese punctuation, or line breaks.
- If the free nodes page on this site provides a new subscription, it is recommended to copy the latest link again and re-import it.
Note: Do not send your subscription link to others, as it usually functions as access to your nodes.
2. Check the IP environment: whether it is restricted or using the wrong route
The subscription server may return different results depending on the IP address used to access it. If your current network is being interfered with by the ISP, restricted by a company or campus network, or if the client is trying to update the subscription through an unavailable proxy, the update will fail.
- Turn off the client proxy, switch back to a direct connection, and then click “Update Subscription.”
- If a direct connection fails, enable a node that is already working, then try updating through the proxy.
- Switch networks for testing, for example from Wi-Fi to a mobile hotspot.
- If there is an option in the client such as “use proxy when updating subscription,” try toggling it on and off for testing.
If it updates successfully after switching networks, the problem is most likely related to the current IP exit or network environment rather than the subscription content itself.
3. Check DNS: whether the subscription domain can be resolved correctly
DNS issues can cause the subscription domain to resolve to the wrong address, resulting in symptoms such as timeouts, connection resets, or certificate mismatches. Ordinary users do not need any complicated configuration and can start with these three things:
- Restart the router and the computer/phone to clear temporary DNS cache.
- Temporarily change the system DNS to 1.1.1.1, 8.8.8.8, or the ISP’s automatic DNS for comparison.
- Disable any suspicious custom DNS rules in Clash/sing-box, then update again.
Key indicator: if the same subscription link opens on mobile data but not on your home Wi-Fi, the common cause is DNS or ISP-level network blocking.
4. The browser environment can also affect the diagnosis
The browser is only a testing tool, but extensions, cache, and the system proxy can interfere with the results. It is recommended to open the subscription link in an incognito window or test with a different browser. If the browser prompts “download file,” that means the link is at least accessible; if it shows a login page, CAPTCHA page, or redirect page, the client often cannot recognize it.
Also check the system proxy: in Windows, you can confirm whether an old proxy is still left behind under “Settings – Network & Internet – Proxy”; in macOS, you can check the proxy items in network settings. A leftover proxy can cause both the browser and the client to use the wrong exit route.
5. Practical troubleshooting steps inside the client
- Delete the old subscription and add the full subscription link again.
- Update the client to a newer version to avoid an old core not supporting a newer format.
- Clear the configuration cache and fetch the subscription again.
- Make sure the date and time are correct; incorrect system time can cause HTTPS certificate validation to fail.
- Check the keywords in the log: timeout usually means a network timeout, 403 usually indicates permission or access restrictions, and 404 usually means the link has become invalid.
Recommended order: first verify the link in the browser, then switch networks, then check DNS, and finally handle the client cache. This is the fastest way to troubleshoot and makes it less likely that you will accidentally delete a working configuration.
If all of the above methods fail, you can basically conclude that the subscription source is temporarily unavailable or that the address has changed. You can wait a while and try again later, or use the free nodes page provided by this site to obtain a new subscription address. Do not refresh repeatedly in quick succession, as overly frequent requests may trigger restrictions.