Local configuration tool
VMess to Clash / Mihomo YAML
Decodes the base64 JSON payload that v2rayN exports, including alterId and the cipher choice.
Conversion happens entirely in your browser. Links are not uploaded, saved, or placed in the page URL.
Conversion result
Why some links are rejected
A parameter that cannot be mapped without changing how the connection behaves is reported rather than dropped. For a Mihomo config that means certificate pinning, TUIC v4 tokens, and uTLS fingerprints on the QUIC-native protocols, where a handshake has nowhere to put one. A silently weakened config is worse than a rejected line.
How to import into Clash Verge Rev
Profiles → new Local profile → pick the downloaded YAML. Clash Verge Rev, Mihomo and ClashX Meta all read the same file; original Clash and Clash Premium do not.
How VMess fields map to Clash
What this converter actually does, line by line. On the left is how it is written in a VMess link; on the right is the field it becomes in the Clash config.
| In the link | In the Clash config | Notes |
|---|---|---|
id | uuid | vmess:// is base64-encoded JSON; these are its field names, not URL parameters. |
add / port | server / port | port is accepted as a string or a number, the way different exporters write it. |
aid | alterId | A non-zero alterId gets a warning: it selects the MD5 authentication path that has since been removed. |
scy | cipher | auto, aes-128-gcm, chacha20-poly1305, none and zero are accepted. |
ps | name | The node name. Falls back to server:port when the field is empty. |
tls: "tls" + sni | tls: true + servername | VMess is spelled the same way as VLESS in every target: servername, server_name, serverName. |
fp / alpn | client-fingerprint / alpn | fp defaults to chrome when the payload leaves it out. |
net=ws + path / host | network: ws + ws-opts | This is the shape v2rayN exports most often. |
net=grpc / httpupgrade | network: grpc / ws + v2ray-http-upgrade | Mihomo folds HTTPUpgrade into WebSocket; the other two give it its own type. |
net=h2 / net=http | network: h2 + h2-opts | Xray has removed the HTTP/2 transport, so that target refuses the line instead of rewriting it as XHTTP — a different protocol on the wire. |
net=xhttp | network: xhttp + xhttp-opts | sing-box has no XHTTP transport, so the line is rejected instead of downgraded. |
type (header obfuscation, e.g. "http") | Rejected with an error | Header obfuscation other than none has no equivalent in any of the three formats. |
FAQ
- Which client do I use after converting VMess to Clash?
- Use Clash Verge Rev, Mihomo (Clash.Meta) or ClashX Meta. Original Clash understands the protocol but not the Mihomo-only keys this config uses, such as xhttp-opts and reality-opts.
- Is this VMess converter free, and does it upload my node links?
- It is free and needs no account. The conversion is done by JavaScript inside this page, on your own machine: links are never uploaded, never written into the page URL, and never stored. Closing the tab is all the cleanup there is.
- Can I convert a subscription link straight to Clash?
- Yes, but paste the body the subscription URL returns — usually one long base64 string — rather than the URL itself, which the browser cannot fetch across origins. Mixed protocols in one subscription are fine. Subscription to Clash converter
- The Clash config converted fine but will not connect — what now?
- This page only translates links into a config: it checks the structure, never whether the server is reachable. Confirm the same link works in the client you copied it from, then check the client version — the XHTTP transport needs Mihomo 1.19 or newer.
This creates a one-time local configuration, not an auto-updating subscription. It checks configuration structure, not whether a server is reachable.