This article addresses a common issue: “What should I do if my subscription link won’t update?” When clients such as Clash, V2RayN, or sing-box report an update failure, timeout, empty configuration, or inability to download a subscription, the cause is usually related to your current IP network, DNS resolution, or browser/system proxy settings. Follow the steps below in order; they’re suitable for everyday users.
1. First, check whether the subscription link is accessible
Many people reinstall the client right away, but you should first check whether the link is valid. Copy the subscription link and paste it into your browser’s address bar. If the browser downloads a block of text or prompts you to save a file, the link is probably working. If you see a 404 or 403 error, an expiration notice, or a blank page, you’ll need to get a new subscription or copy the complete link again.
- Make sure you copied every character in the link, especially the parameters at the end.
- Don’t include any spaces or line breaks when copying the subscription link.
- If you’re using the free nodes page on this site, recopy the latest subscription URL before importing it.
Note: A subscription link isn’t a regular webpage. Some browsers may display garbled text or download a file; this doesn’t necessarily mean there’s a problem.
2. Check your IP network: it may be blocking the subscription domain
Subscription update failures are common on corporate, campus, and public Wi-Fi networks, as well as some carrier networks. Symptoms include the client spinning indefinitely or displaying errors such as timeout, connection refused, or failed to fetch. Try switching networks—for example, switch from Wi-Fi to your phone’s hotspot, or vice versa.
- Turn off the client’s proxy and connect directly through your system.
- Switch to mobile data or a different Wi-Fi network.
- Tap “Update subscription” in the client again.
- If the update works on the other network, your original network’s IP address or firewall is likely blocking access.
If you’re overseas or using a complex proxy chain, the subscription server may be blocking your exit IP address. Try updating on the simplest network possible, without running multiple proxy tools at the same time.
3. DNS issues: being able to get online doesn’t mean the subscription domain can be resolved
DNS problems can make your browser appear to work normally while preventing the client from resolving the subscription domain. Try changing your system DNS to a well-known public DNS server, then refresh the subscription. Windows users can change their IPv4 DNS settings in the network adapter properties; phone users can change DNS in their Wi-Fi settings.
Try clearing the DNS cache first, then changing DNS, and finally restarting the client. On Windows, run ipconfig /flushdns in Command Prompt. On macOS and phones, restarting the network or toggling Airplane Mode usually does the trick.
Important: If the client log shows “no such host” or “DNS lookup failed,” troubleshoot DNS first rather than the node protocol.
4. Browser and system proxy settings can also affect updates
Some users can open the subscription in their browser but can’t update it in the client because the browser uses a proxy extension while the client uses the system network. Others may have an old client occupying the system proxy, causing subscription requests from a newer client to fail.
- Turn off browser proxy extensions and try opening the subscription directly again.
- Check whether your system proxy is still pointing to a 127.0.0.1 port.
- Exit other proxy software and run only one client at a time.
- In Clash or sing-box, try switching between “Update directly” and “Update subscription through proxy.”
Tip: Keep your setup simple when updating subscriptions, and avoid letting multiple clients take over proxy ports at the same time.
5. Steps to take in the client
If the link is valid and your network is working, try rebuilding the configuration in the client. For Clash-based clients, delete the old configuration and import the URL again. In V2RayN, edit the address in the subscription group and update it manually. In sing-box GUI clients, check that the configuration source is a remote subscription.
- Back up your working nodes or configuration.
- Delete the old subscription group that failed.
- Paste the complete subscription link again.
- Click Update and check the log for the specific error.
- Once the update succeeds, select a node and test its latency.
If the log shows a certificate error or an incorrect time, correct your system date and time. If it shows 401 or 403, the subscription has likely expired, has an access issue, or is subject to source restrictions. You’ll need to get a valid subscription.
Summary: If your subscription link won’t update, troubleshoot in this order: “link validity → IP network → DNS → proxy settings → client logs.” Following these steps will usually help you pinpoint the problem quickly and avoid reinstalling the client over and over.