This article addresses the common issue of subscription links failing to update: clicking Update in the client does nothing, a network error appears, the subscription is empty, the link opens in a browser but won’t update in the app, or a newly added free-node subscription never takes effect. Follow the steps below to check your IP, DNS, browser environment, and client settings. They’re suitable for everyday users.
1. First, check whether the subscription link is accessible
If a subscription update fails, don’t rush to reinstall the client. First, check whether the link itself is working. Copy the subscription link and paste it into your browser’s address bar. If you see a list of node configurations, Base64 text, or a file that downloads automatically, the link is probably working. If you see a 404 or 403 error, a timeout, or a blank page, the link may have expired, been copied incompletely, or be inaccessible from your current network.
- Check that the link starts with http:// or https:// and that no characters are missing.
- Make sure you haven’t copied any spaces, line breaks, or Chinese punctuation.
- If you’re using this site’s free-node subscription, go back to the latest page and copy the link again to avoid using an old cached version.
Important: A subscription link is not a node itself. It’s the address the client uses to fetch the node list. If the link won’t open, the client usually won’t be able to update either.
2. IP and network issues that can prevent updates
Some subscription addresses may be inaccessible because of your current IP, your ISP’s network, or restrictions on a company or campus network. First, try switching networks—for example, switch from Wi-Fi to a mobile hotspot, or from mobile data to a broadband connection. If the update works on another network, the issue is probably with your original network’s public IP or network policies.
- Turn off your proxy or VPN, then try updating the subscription over a direct connection.
- If the direct connection fails, connect to a working node and try updating the subscription again.
- Try a mobile hotspot to see if your broadband provider is the issue.
- Restart your router, wait for it to obtain a new public IP, then try again.
Note that some clients have an option to “Update subscription through proxy.” If your current node isn’t working and this option is enabled, the update will fail. In that case, switch to a direct connection first. If your network is blocking the subscription address, switch to updating through a working proxy instead.
3. How to troubleshoot DNS resolution issues
DNS translates subscription domains into IP addresses. If DNS isn’t working properly, your browser may report that it can’t find the server, while the client may show a timeout or “failed to fetch” error. Temporarily change your system DNS to a common public DNS server, such as 1.1.1.1, 8.8.8.8, or 223.5.5.5, then try updating again.
On Windows, you can change DNS in your network adapter’s IPv4 settings. On macOS, add a DNS server under “System Settings > Network > Details > DNS.” On Android and iOS, first try switching networks or using the system’s Private DNS feature. After making changes, we recommend clearing the client’s cache and restarting the app to avoid using an old DNS result.
4. Differences between browsers and clients
Many people find that a link opens in a browser but won’t update in Clash, V2RayN, or sing-box. This is usually because clients handle requests differently and may be affected by certificates, the User-Agent, system proxy settings, or the system clock. First, check that your system time is correct. A large time discrepancy can cause HTTPS certificate verification to fail.
- Update the client to a recent version. Older versions may not support some subscription formats.
- Delete the old link in your subscription settings, then paste it again and save.
- Try again after disabling browser extensions, packet-capture tools, and your antivirus’s HTTPS scanning.
- If your client supports it, switch between “Update directly” and “Update through proxy.”
Don’t repeatedly import the same faulty link, as this can create duplicate groups or cause cache issues. Delete the old subscription first, then add it again.
5. Quick checklist if it still fails
If you’ve tried all the steps above, run through this checklist in order: copy the latest subscription link again; switch networks; change DNS; restart the client; update the software; delete the subscription and import it again; check the logs for keywords such as timeout, 403, SSL, or DNS. If the logs indicate a format error, the subscription may not be in a format your client supports. Try using a compatible client or converting it to a supported format.
Conclusion: Subscription updates usually fail for more than one reason. The link’s validity, IP and network, DNS resolution, and the client’s request environment can all play a part. Follow the steps in this article to identify whether the issue lies with the link, the network, or the software settings.