This article explains how to fix subscription link update failures. Whether you use Clash, V2RayN, sing-box, or Shadowrocket, follow the steps below to troubleshoot your IP, DNS, browser, and client environment if refreshing a subscription fails, the downloaded configuration is empty, or you see a network error.
1. First, check whether the subscription link is accessible
A failed subscription update doesn’t necessarily mean the nodes are no longer working. Often, the link is being blocked, DNS resolution is failing, or the client has cached data. Start by copying the subscription link instead of repeatedly clicking “Update” in the client.
- Copy the entire subscription link and make sure it contains no extra spaces, line breaks, or non-ASCII punctuation.
- Open the link in a browser and check whether it downloads a text file or displays configuration content.
- If you see a 404 or 403 error, or a message that the link has expired, the subscription URL may no longer be valid. You’ll need a new one.
- If the link opens in your browser but the client can’t update, check the client’s proxy settings, DNS, and cache.
If you use the free node subscription provided on this site, check the page first to confirm that today’s working link has been published, then copy the latest subscription URL.
2. Your IP and network can affect subscription updates
Some subscription links behave differently depending on the network you’re using. For example, corporate networks, campus networks, and public Wi-Fi may restrict external downloads. The exit IPs used by mobile networks and broadband connections may also trigger security checks.
- Switch networks: Switch from Wi-Fi to your phone’s hotspot, or from mobile data to your home broadband, then try updating again.
- Turn off the global proxy and try again: Updating a subscription through an incorrect proxy connection can prevent some clients from connecting to the subscription server.
- Check your system time: A significant time difference can cause HTTPS certificate validation to fail and prevent the subscription from downloading.
If switching networks fixes the issue, the problem is probably not with the client. Your current IP or network may simply have unreliable access to the subscription URL.
3. Troubleshoot DNS and your browser
DNS issues are among the most common, yet easily overlooked, causes of subscription update failures. Symptoms include the link not opening in a browser, or the client displaying “timeout,” “connection failed,” or a domain resolution error.
- Temporarily change your system DNS to a commonly used public DNS server, such as 1.1.1.1 or 8.8.8.8.
- Clear your browser cache or open the subscription link in a private browsing window.
- Try a different browser, such as Chrome, Edge, or Firefox.
- In Clash or sing-box, check whether any DNS rules are affecting direct connections.
Note: Being able to open webpages in your browser doesn’t guarantee that the subscription will download. Subscriptions are usually plain text or base64 content, and some extensions, ad blockers, or security software may block the download request.
4. How to troubleshoot in your client
The steps for refreshing a subscription vary by client, but the general approach is the same: clear the old cache, then import the subscription again.
- Clash Verge / Clash Meta: Go to Profiles, delete the old configuration, paste in the subscription URL again, and click Update.
- V2RayN: Select “Update subscription” in the subscription group. If it fails, delete the group and add it again.
- sing-box clients: Check that the configuration source URL is complete, and reimport it if necessary.
- iOS clients: Make sure cellular data is allowed so the system doesn’t restrict background refreshes.
If no nodes appear after updating, the subscription format may be incompatible with your client. Try a client that supports Clash, V2Ray, or a universal subscription format.
5. Quick checks if the problem persists
Use these three checks: If the link won’t open in your browser, the issue is probably with the link, DNS, or network. If it opens in your browser but the client fails, the issue is probably with the client cache or proxy settings. If others can update but you can’t, the issue is probably related to your device’s IP, DNS, or security software. Troubleshooting in this order will usually help you identify the cause quickly.