This article addresses the common issue of “what to do if a subscription link won’t update”: if clicking update subscription in clients like Clash, V2RayN, or sing-box does nothing, shows a timeout, reports a download failure, or the node list does not change, you can troubleshoot step by step from network, IP, DNS, and browser/system environment using the methods below.
1. First, confirm that the subscription link itself is accessible
If a subscription update fails, the first step is not to repeatedly reinstall the client, but to check whether the link has expired or become invalid. Copy the subscription link and paste it into your browser’s address bar; if it downloads a block of text or automatically prompts a file download, the link is basically usable. If it shows 404, 403, a blank page, or requires login, the client usually will not be able to update either.
- Check whether the link was copied completely, and be especially careful not to miss the final parameters.
- Confirm that the subscription has not expired; some free node subscriptions change addresses regularly.
- If the free node page on this site has been updated, it is recommended to copy the latest subscription link again.
Note: do not import a node share link as a subscription link, as the two may use different formats.
2. Abnormal IP environment: switch networks or turn off the proxy and try again
Some subscription addresses may fail to update because of changes in access IP, proxy loops, or network restrictions. A common situation is that the client’s proxy is already enabled, but the subscription update also goes through the current proxy, causing the request to loop around and eventually time out.
- First turn off the client’s proxy mode, and exit system proxy or TUN mode.
- Switch to a different network for testing, such as a mobile hotspot, home broadband, or company network.
- If you are using public Wi-Fi, try switching to a 4G/5G network.
- Restart the router, obtain a new local network environment, and then update again.
If updating works after switching networks, it indicates that the original network’s IP, gateway, or ISP DNS may be affecting access. In that case, you can keep using the working network to update the subscription, then switch back to the original network to connect to nodes.
3. DNS resolution issues: switch to a reliable DNS
If the subscription link cannot be updated, it may also be due to a domain name resolution failure. Typical signs are that the browser cannot open the subscription domain, and the client reports errors such as DNS lookup failed, timeout, or connection refused. You can temporarily change the DNS in your system network settings.
Common public DNS options include 1.1.1.1, 8.8.8.8, and 223.5.5.5. After changing them, it is recommended to refresh the DNS cache once, or simply restart your computer or phone. Windows users can run ipconfig /flushdns in Command Prompt.
Key point: if the client has built-in DNS settings, also check whether an unusable remote DNS is enabled; if necessary, restore the default configuration before updating the subscription.
4. Browser and system environment can also affect updates
Some users can open the subscription in a browser but the client update still fails. This is usually related to system proxy settings, certificates, time, or permissions. Please check whether the system date and time are accurate, whether the client is being blocked by security software, and whether multiple proxy tools are running at the same time.
- Windows: run the client as administrator and make sure the firewall is not blocking network access.
- macOS: check the network proxy settings and disable unrelated proxy configurations.
- Android/iOS: make sure the client has network permissions, and disable battery-saving restrictions if necessary.
- Browser: try opening the subscription in incognito mode to rule out cache and extension interference.
Do not enable multiple proxy clients at the same time, for example letting Clash and V2RayN both take over the system proxy, as this can easily cause subscription requests to use the wrong exit route.
5. The correct way to update inside the client
In Clash-based clients, you usually go to “Configuration/Profile,” select the corresponding subscription, and click update; in V2RayN, you can choose update subscription under “Subscription Groups”; in sing-box GUI clients, refresh is generally on the Profile or Subscription page. If the node list does not change after updating, you can first delete the old configuration and then re-import the subscription.
Finally, it is recommended to troubleshoot in order: link validity → turn off proxy → switch network/IP → change DNS → check client permissions. Most issues behind “what to do if a subscription link won’t update” can be identified through these steps. If it still fails, record the error screenshot, client name, system version, and what happens when opening the subscription, then make a further diagnosis.