Is a V2Ray config a file or a link?
It is any of three things: a JSON file, a share link or a subscription. The JSON file is what the core reads: the Xray documentation describes it as JSON with named sections, among them log, DNS, routing, inbounds and outbounds. Inbounds say how apps hand traffic in; outbounds say which server it leaves through.
A share link is that same information squeezed into one line that starts with "vless://" or "vmess://", so a phone app can fill in a single server with one paste. A subscription is an address the app visits to collect a whole list of such links, and to collect it again later.
On a phone you will almost always handle the second or third kind. The raw JSON matters when you run your own server or build a client setup by hand.
What is inside a vless:// link?
Read it from left to right. The pattern in the Xray share-link proposal is the protocol, then the user ID, an at sign, the server address and port, a question mark with settings, and a hash sign with a display name.
A harmless example in the shape the Xray share-link proposal describes looks like "vless://00000000-0000-0000-0000-000000000000@example.com:443?security=tls&type=ws&sni=example.com#my-phone". The zeros stand in for a real ID, and example.com stands in for a real host. Your own link will carry the real values, and the ID is the part that behaves like a password.
Fields at a glance
| Field | What it tells the app | Slip that breaks it |
|---|---|---|
| security | Whether TLS or REALITY wraps the connection, or nothing | Writing "xtls" from an old tutorial |
| type | The transport, such as tcp, ws, grpc or xhttp | Capital letters, because values are case-sensitive |
| sni | The server name used in the TLS handshake | Leaving it out when the host is a bare IP |
| fp | The browser fingerprint the client imitates, Chrome by default | Omitting it when REALITY is in use |
| flow | Traffic mode such as xtls-rprx-vision | Setting it on a transport that does not support it |
| Text after the hash sign | Only the label you see in the list | Expecting it to change how the link behaves |
Why did a link from a chat fail to import?
Usually because the text changed on the way. The share-link proposal says parameter names and constant values are case-sensitive, that a field must not appear twice, and that values need URL escaping. A chat app that wraps a long line, adds a space or turns a character into a smart quote breaks at least one of those rules.
Paste the link into a plain notes app first and check that it is one unbroken line. If the app still refuses, count the parts: user ID, host, port, then settings. A missing port leaves the link without an address to dial.
Is a config file from a GitHub list safe to use?
Treat it as somebody else's server, because that is what it is. The owner of the machine can see which addresses you connect to, and nothing obliges them to keep the server running next week. A list on GitHub tells you who typed it, not who operates the servers inside it.
Read each entry before you import it. A line that carries a strange host, an odd port or a transport you did not expect is a reason to skip it.
Which app opens which config?
Each app decides for itself. According to the v2rayN wiki, its subscription feature takes nine protocols, with VLESS, VMess and Trojan among them. A different client may take fewer.
Our own key is a subscription link that opens in Happ. Since we sell that key, weigh this mention as coming from a seller. Happ's App Store entry shows it as free and asks for iOS 15.0 or later.
Questions
Does the name after the hash sign change how the link works?
No. The proposal calls it descriptive text, meant only as the display name in your server list. Rename it freely, but keep it URL-escaped if it holds spaces or non-Latin letters, otherwise the line may be cut at the wrong place and the import fails.
A friend sent me a config in a chat. Should I use it?
Ask who runs the server first. A link carries the host name and the user ID, so whoever owns that machine sees where your traffic goes. If your friend cannot answer, treat the link like an unknown Wi-Fi network.
Can I turn a JSON file into a link myself?
You can, because the link is a compact form of the outbound settings. The fiddly part is escaping the values and getting the transport name right. A converter does it faster; check the output against the field table above before you trust it.
Where do I read more on each kind of config?
The pages under this one take them in turn. They cover link parts to check before a paste, subscription refreshes, the V2Ray mode in HTTP Injector and HTTP Custom, free config files, VMess links and JSON converters.
Will the key from the bot work as a JSON file?
It arrives as a subscription link, not as a file, and the bot issues it in about a minute. You paste it into Happ and the app downloads the server list. The 10-day trial uses the same link, and up to 5 devices can share it.
Questions answered by Rohan Deshmukh, V2Ray guides editor
10 days free, up to 5 devices.
Get 10 days free