DEV Community

Mike
Mike

Posted on

Clash Verge imported the subscription but shows no nodes: find which of the four steps failed

When a subscription import goes wrong, most people switch nodes or reinstall the client. That rarely helps. A working connection goes through four steps. You get the subscription link, the client downloads the config, the client parses nodes out of it, and you turn the connection on. Find the step that failed before you change anything.

This applies to Clash Verge Rev, FlClash and Shadowrocket.

Match what you see to a step

What you see Step that failed Check first
One-click import does nothing The browser could not open the client Is the client installed? Paste the link inside the client instead
Download timeout or client error (Connect) Downloading the config Is the link complete, is the plan still active, can this network reach the subscription host
YAML error or configuration parse failed Parsing the config Did you copy the right format, or did you get a login page back
The subscription card is there but the proxy list is empty Parsing or activation Is this profile the selected one, and check quota and expiry
Nodes show latency but pages will not load Turning the connection on System proxy or TUN, and which node the rule picked

The download fails

  1. Copy the link again from your provider's account page. Chat apps wrap long links or turn them into preview cards, and a link read off a screenshot is usually incomplete.
  2. Check that the plan has not expired and still has quota. An expired subscription often returns an empty body or a short notice.
  3. Being able to open a normal website does not prove the client can download the subscription. Those are two different paths. When you test on another network, change only the network and keep the same client and link.
  4. Do not turn off certificate verification to make it pass.

Format errors

Clash Verge Rev and FlClash want a Clash subscription, which is YAML. Shadowrocket uses a generic subscription, which is a Base64 list. Providers normally offer both. Copy the wrong one and you get a format error, or an import that succeeds with no nodes.

There is a second common cause. The subscription URL returns an HTML login or error page, and the client tries to parse a web page as a config. The message you see is still a format error.

To find out what you actually have, paste the content into the config checker we built at NailongVPN

https://nailongvpn.com/en/tools/clash-config-check

It tells apart a subscription URL, a Base64 node list, an HTML page and Clash YAML, and reports the problem type and line number. It runs in your browser, uploads nothing, never opens your subscription URL and needs no sign-in. It checks structure only. It does not test whether a node connects.

One warning. Do not paste a subscription link that carries your credentials into an online converter you do not know.

A card but no nodes

The card only means the subscription was saved. It does not mean nodes were read.

  1. Press update once and watch for an error.
  2. Confirm the selected profile is the one you just updated. This is easy to get wrong with several subscriptions saved.
  3. Open the proxy list again. If it is still empty, go back to the format section.

Nodes are there but nothing connects

At this point it is no longer an import problem.

  1. Turn on system proxy. Some apps ignore it, so try TUN mode next.
  2. Look at which node the rule picked for the site you are opening.
  3. Hysteria2 runs over UDP and some networks throttle UDP. If latency tests look fine but pages crawl, try a Trojan node on the same line.
  4. Check that your system clock is correct.
  5. Confirm your real exit with any IP check page. Your terminal and each app may take a different path, so check them separately.

Before you contact support

Have these ready. Device and OS version, client and version, which subscription format you used, the step that failed, the exact error text and the time it happened. Cover the full subscription link and node passwords in screenshots.

References

Disclosure. I work on NailongVPN (nailongvpn.com), and the checker above is a free tool we made. A longer step-by-step version is at https://nailongvpn.com/en/learn/subscription-import-errors

Top comments (0)