Structured, version-checked references for the proxy clients people actually run into trouble with: Clash Verge Rev, Clash Meta / Mihomo, v2rayN, v2rayNG, Hiddify, sing-box, FlClash.
The point is not to collect error messages. It is to say which stage failed and what the shortest verifiable fix is — and to be explicit when a claim cannot be verified.
20 exact error strings mapped to cause and fix, grouped by failure stage:
| Stage | Example error |
|---|---|
| Config parsing | the remote profile data is invalid yaml |
| Service / IPC | cannot select profile: socket error, service core IPC timeout |
| DNS | set system dns failed: exit code 1 |
| TUN / routing | nftables operation not supported, exit status 127 |
| Subscription import | ArgumentOutOfRangeException, gzip import failure |
| TLS / transport | allowInsecure has been removed |
Each entry records the client, the platform, the version range where the error was observed, the upstream issue where one exists, and the evidence boundary — what was reproduced and what was not.
Ten clients compared on the fields that actually determine whether a fix applies to you: platform support, routing core, TUN implementation, rule system, configuration format, open or closed source, and pricing model.
Clash Verge Rev · FlClash · v2rayN · v2rayNG · Shadowrocket · Surge · Stash · sing-box · Hiddify · Karing
Why the same subscription URL imports cleanly in one client and silently loses half its nodes in
another: base64 node lists vs Clash YAML vs sing-box JSON, the subscription-userinfo header, and
the field mismatches that conversion tools drop without warning.
- Errors are quoted verbatim, not paraphrased, so they stay searchable and diffable.
- Every entry states the client version it was observed on. Behaviour changes between releases; an entry without a version is treated as unverified.
- Upstream issue numbers are linked when they exist, so the reader can check the maintainer's own explanation rather than trusting a blog post.
- Corrections are welcome as issues or pull requests. If an entry is wrong for your version, say which version and what you saw.
- Long-form write-ups, in Chinese, with screenshots and step-by-step checks: jiedianshouce.com
- Error index page: jiedianshouce.com/troubleshooting
These repositories do not host subscriptions, node addresses, tokens or configuration files that can be connected directly.