This article addresses the common issue of “subscription link not updating.” If updating a subscription in clients such as Clash, V2RayN, or sing-box fails, times out, downloads an empty file, or leaves your nodes unchanged, follow the steps below to check your network IP, DNS, browser environment, and client settings.
1. First, check whether the subscription link is accessible
Many update failures aren’t caused by a faulty client—the subscription URL itself may be unavailable. Copy the link and paste it into your browser’s address bar instead of opening it directly from a chat app. If a block of configuration text downloads, the link is probably working. If you see a 404 or 403 error, a blank page, or an endless loading indicator, the link may have expired, been blocked, or be unreachable from your network.
- Make sure the link is complete and doesn’t contain extra spaces, line breaks, or Chinese punctuation.
- Check whether the subscription has expired. Free-node subscriptions may change their URLs periodically.
- Test the link in a private browsing window to rule out browser cache issues.
- If our free nodes page has a new subscription link, try replacing the old one with the latest link.
2. How your IP and network environment can affect updates
Subscription update requests are sent from your current network connection. If the target server restricts your IP address, or your network blocks the URL, the update will fail. Common signs include being able to update over mobile data but not on home Wi-Fi, or seeing timeouts on a company or campus network.
First, try switching networks: move from Wi-Fi to a mobile hotspot, or restart your router to get a new IP address. If your client supports “update subscriptions through proxy,” enable that option so the request uses a working proxy connection. Avoid repeatedly refreshing while completely offline, as the client may cache the failed result.
3. Check DNS, your browser, and system proxy settings
DNS resolution issues can also prevent the subscription domain from opening. Try temporarily changing your system DNS to a common public DNS server, or turn Private DNS on or off on your phone and try again. After changing DNS, restart the client and, if needed, your device.
- Clash-based clients: Check that the subscription URL in your configuration is correct, then try “Update all subscriptions.”
- V2RayN: Right-click the subscription group and select Update subscription. If it fails, check the error shown in the log.
- sing-box clients: Make sure the converted subscription configuration format is supported by your current version.
- When testing in a browser, disable ad-blocking and script-blocking extensions to prevent them from interfering with the download.
If the subscription opens in your browser but won’t update in the client, check whether the client has system proxy, Tun mode, or network permissions enabled. Windows Firewall and antivirus software may also block the client’s network access.
4. Follow these steps to troubleshoot quickly
- Copy the subscription link again and make sure it contains no extra characters.
- Test it in a browser. If it opens, return to the client and import it.
- Switch to mobile data or a hotspot, or restart your router to rule out an IP issue.
- Change your DNS, then clear your browser cache or use a private browsing window.
- Enable “update subscriptions through proxy” in the client, then update manually.
- If it still fails, delete the old subscription group and add the latest subscription URL again.
Finally, keep in mind that a successful subscription update doesn’t mean every node will connect. Nodes can also be affected by connection status, protocol support, and your local network. To troubleshoot efficiently, first check whether the subscription downloads, then test whether individual nodes are usable.