What is a VLESS key and how to import it into Happ or v2rayTun
A VLESS key is a single link that starts with vless:// and contains everything a client app needs: the server address and port, your personal UUID, and the transport parameters such as Reality's public key and SNI. You never edit it; you copy it from your dashboard and import it into the app by clipboard or QR code. In the 404 VPN apps you do not need keys at all: you sign in and the app fetches them. Import takes ten seconds. If it fails, it is almost always because a chat app changed a character.
Anatomy of a key
vless://<uuid>@<host>:<port>?security=reality&sni=<site>&pbk=<public key>&sid=<short id>&fp=chrome&flow=xtls-rprx-vision&type=tcp#404 VPN
| Part | Meaning |
|---|---|
uuid | your identity on the server; treat it like a password |
host:port | the server and its port; WebSocket entries use 443 |
security=reality | the transport is Reality; other keys say tls or none |
sni | the public site the handshake imitates; must match the server |
pbk, sid | Reality public key and short ID; must match the server |
fp=chrome | which browser fingerprint the client mimics |
flow=xtls-rprx-vision | the Vision flow that removes the TLS-in-TLS pattern |
type | tcp for Reality, ws for WebSocket, xhttp for XHTTP |
#name | a label the app shows |
A WebSocket entry has security=tls, type=ws and a path instead of pbk and sid.
Single key or subscription link
The dashboard gives you both. A single key is one server with one transport. The subscription link is an https:// address that returns all your keys, and the app refreshes it on its own, so new servers and transports appear without re-importing. Use the subscription link unless you want to pin a specific entry. Details in subscription link vs single key.
How to import
- In the dashboard open the keys page, choose a server and copy its key, or leave the QR code on screen. For the subscription link use the VPN tab.
- Open the app and tap the plus button.
- Choose Import from clipboard, or Scan QR if the key is on another screen.
- The entry appears in the list with the label from the key. Tap it, press Connect.
Platform guides: iPhone and iPad, Android, macOS, Windows.
When the import fails
- "Invalid link" or nothing happens. The key was altered in transit. Messaging apps replace
&with&, add a space or turn the link into a preview card. Copy again directly from the dashboard, or scan the QR code. - Imports, but will not connect. Compare
sni,pbkandsidwith the dashboard. See Reality not working. - The app says it does not support
flow. The client is older than Xray 1.8. Update it.
Keep the key private
Anyone with the key can use your account's traffic and device slots. Do not post it in public chats or screenshots. If it leaks, write to help@404vpn.io from the account email and we reissue it: the old key stops working and every device needs the new one.
FAQ
Is a VLESS key the same as a config file?
A key is one line; a config file is the JSON that Xray or sing-box reads on a server or router. The apps turn the key into a config for you. For routers you write the config by hand; see the OpenWrt guide.
Can I use one key on several devices?
Yes, up to the number of devices on your plan, from 1 to 8.
Why does the key have a # and a name at the end?
That is the label the app displays. You can rename it in the app without affecting the connection.
Can I generate my own key?
No. The UUID must exist on the server. Keys come from the dashboard only.