This article addresses a common issue: “What should I do if my subscription link won’t update?” Whether you use Clash, V2RayN, sing-box, or Shadowrocket, follow the steps below to troubleshoot subscription downloads that fail or show a timeout, a blank page, a 403/404 error, or no change in nodes after updating. Check the link, IP, DNS, and browser environment one by one.
First, check whether the subscription link works
A failed subscription update doesn’t necessarily mean the client is broken. The most common causes are an expired link, an incomplete copy, or a network that can’t access the subscription address. First, copy the full subscription link and paste it into your browser’s address bar. If you see configuration text or a file downloads automatically, the link is likely accessible. If the page says the resource doesn’t exist, shows a permissions error, or is blank, you’ll usually need a valid subscription link.
- Check that the link starts with http:// or https:// and has no extra spaces at the end.
- Make sure you haven’t confused the QR code contents, a webpage URL, and the subscription URL.
- If you’re using this site’s free-node subscription, return to the latest page and copy the link again to avoid using an expired one.
- Delete the old subscription in your client and add it again; don’t just click “Update.”
Note: Some clients cache old content, so the interface may not change immediately even after the subscription updates. Restart the client and refresh it again.
What to do if your IP environment is preventing updates
Subscription addresses may restrict unusual access, frequent requests, or certain network egress points. If updates fail on a company network, campus network, or public Wi-Fi, but the link opens on mobile data, the issue is probably with your current IP or network policy.
- Switch to your phone’s hotspot and try updating again to check whether your broadband IP is the problem.
- Turn off any proxy you’re currently using and try updating. If the subscription address requires a proxy, enable global proxy mode and try again.
- Avoid clicking Update repeatedly in quick succession. Wait a few minutes before trying again.
- If your router has been online for a long time, restart your modem or router so the network can obtain a new egress IP.
In Clash-based clients, also make sure that “subscription updates” are using the correct network. Some versions let you use the system proxy for updates. If this setting is configured incorrectly, the link may open in your browser while the client fails to update.
Troubleshoot DNS and your browser environment
DNS issues can also make a subscription link appear to be broken. For example, your browser might say it can’t resolve the domain, show a connection reset error, or take a long time to load. Try temporarily changing your system DNS to a common public DNS server, or enabling the client’s built-in DNS before trying again. After making the change, disconnect and reconnect to the network so the old DNS results aren’t still being used.
Browser settings can also affect your troubleshooting. Open the subscription link in a private window, and disable ad blockers, script blockers, and download manager extensions. If it won’t open in one browser, try Chrome, Edge, or a browser on your phone. If the link opens in a browser but fails in the client, focus on the client version, subscription format, and proxy mode.
How to fix the issue in your client
The options may have slightly different names in different clients, but the general process is the same: back up any working configuration, remove the old subscription, then import it again. For example, in Clash, delete the old configuration under Profiles/Config and paste in the URL. In V2RayN, update the subscription from the subscription group. In sing-box graphical clients, add the link from the Profile or Subscription page.
The key step is to manually select a node after updating and run a latency test, then switch to rule-based or global mode and visit a webpage to verify the connection. If you see errors such as YAML parse error, base64 decode failed, or invalid config, the subscription content may be incompatible with your client. You’ll need a subscription link in the appropriate format.
Finally, if you’re still wondering what to do when your subscription link won’t update, troubleshoot in this order: check whether it opens in a browser, try another network, change DNS, reinstall the subscription, then try another client. Don’t keep changing unrelated settings. Work through the steps one by one, and you’ll usually find the cause.