Skip to content
RayTun

Subscriptions

How V2RayTun's all-in-one subscription URLs work — a single link delivering configs for every protocol.

How Subscriptions Work

Every user in V2RayTun gets a unique subscription URL. When a client app fetches this URL, it receives a base64-encoded list of connection URIs for all protocols and nodes the user has access to — in a single response.

Subscription URL Format

Text
https://sub.example.com/api/sub/{shortUuid}
  • sub.example.com — your subscription domain.
  • {shortUuid} — the user's unique short identifier, generated by the panel.

What the Client Receives

The response body is a base64-encoded string. When decoded, it contains one URI per line:

Text
vless://uuid@ip1:443?type=tcp&security=reality&sni=www.google.com&fp=chrome&pbk=...&sid=...&flow=xtls-rprx-vision#Node1-VLESS
hysteria2://pass@ip1:8443/?insecure=1&sni=...&obfs=salamander&obfs-password=...#Node1-Hysteria2
awg://privkey@ip1:51820/?publickey=...&address=10.8.0.2/32&mtu=1420&presharedkey=...&dns=1.1.1.1&jc=4&jmin=40&jmax=70&s1=0&s2=0&h1=1&h2=2&h3=3&h4=4#Node1-AWG
vless://uuid@ip2:443?type=tcp&security=reality&sni=www.google.com&fp=chrome&pbk=...&sid=...&flow=xtls-rprx-vision#Node2-VLESS
hysteria2://pass@ip2:8443/?insecure=1&sni=...&obfs=salamander&obfs-password=...#Node2-Hysteria2

Each line follows the standard URI format for its protocol.

Access Control via Squads

Which nodes and protocols appear in a user's subscription is controlled by their Squad assignment:

  • Users in Default-Squad receive configs for all nodes automatically.
  • Users in a custom squad only receive configs for nodes and protocols assigned to that squad.

See Squads for details.

Fetching the Subscription

curl

Bash
curl -s https://sub.example.com/api/sub/abc123 | base64 -d

In a Client App

Most proxy clients (v2rayNG, Hiddify, Streisand, AmneziaVPN) support adding a subscription URL directly. The client periodically fetches and updates configs automatically.

  1. Open the client's subscription settings.
  2. Paste the subscription URL.
  3. Tap Update — all available servers appear in the server list.

Subscription Refresh

When you add or remove nodes, change squad assignments, or modify host configurations, the subscription output updates instantly. Clients pick up changes on their next refresh cycle.