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, an update failure usually has more than one possible cause. It may be related to your current IP, DNS resolution, browser cache, client settings, or the subscription URL itself. Follow the steps below in order to troubleshoot the issue.
1. First, check whether the subscription link is accessible
When a client reports an update failure, many people assume that all their nodes are down. First, try copying the subscription link into your browser’s address bar and opening it. Normally, you may see a long string of configuration data, a downloaded file, or a prompt to import it into a client. If the link won’t open in your browser either, check whether it has expired, your network is blocking it, or there’s a problem with your local environment.
- Copy the entire subscription link and make sure no characters are missing.
- Test the link using both mobile data and Wi-Fi.
- Try another browser, such as Chrome, Edge, or Safari.
- If this site’s free nodes page provides a new subscription URL, try copying the latest link.
Note: Don’t take screenshots of or publicly share your subscription link. It may contain access details specific to you.
2. Check your IP environment: your current network may be restricted
To update a subscription, your device first needs to connect to the subscription server. If your current broadband, work or campus network, or public Wi-Fi restricts the relevant domains, your client may show errors such as timeout, connection refused, or network error. Try switching to a mobile hotspot. If the update works over the hotspot, your original network may be blocking the connection or have a routing issue.
If you’re already connected to a proxy node, updating your subscription may also fail. Some clients use the “current proxy” to fetch subscriptions, so an unavailable node can create a loop. Try disconnecting from the proxy, or compare the results by enabling “Use system proxy to update subscriptions” or “Update subscriptions directly” in your client.
3. DNS resolution issues can also cause update failures
DNS translates subscription domains into IP addresses. DNS poisoning, issues with your ISP’s DNS cache, or incorrect DNS settings on your router can all prevent a subscription link from opening. Try temporarily changing your device’s DNS to a commonly used public DNS server, then update the subscription again.
- Windows: Change your IPv4 DNS settings in the network adapter properties.
- macOS: Change your DNS settings in the network details under System Settings.
- Android/iOS: Adjust DNS in the network settings for the current Wi-Fi connection.
- Router: If multiple devices are affected, check the router’s DNS settings.
Tip: After changing DNS, close and reopen the client before updating the subscription so it won’t keep using the old DNS cache.
4. Check your browser environment and client cache
Sometimes a subscription link opens in a browser, but the client still fails to update. Common causes include a cached old URL, a corrupted subscription group, an incorrect system clock, or the server rejecting the User-Agent. Try deleting the old subscription group and adding it again instead of repeatedly clicking Update on the existing one.
- Set the correct time on your phone or computer and enable automatic time sync.
- Clear the client’s cache or restart the client.
- Delete the old subscription and reimport it by pasting the full link.
- Make sure the link starts with http:// or https:// and contains no spaces.
If your browser shows a certificate error, your system clock may be incorrect, your network may be intercepting traffic, or the certificate chain may be invalid. Don’t ignore the security warning; try a different network first.
5. Quick troubleshooting tips for different clients
In Clash-based clients, check the logs for keywords such as DNS, timeout, 403, or 404. In V2RayN, try “Update subscriptions without proxy” or import the subscription again. For sing-box clients, make sure the configuration file hasn’t been overwritten by an old subscription. If an iOS client stops responding for a long time, close it in the background and reopen it.
Bottom line: If the same subscription link won’t open across multiple networks, browsers, and clients, the URL has probably expired or the server is temporarily unavailable. If it fails only on one network, focus on your IP and DNS. If it fails only in one client, reinstalling the client or recreating the subscription group is usually the quickest fix.