Client setup

Set Up Hiddify for VLESS Reality and Hysteria2

Hiddify is a free, open-source app for Android, iOS, Windows, macOS and Linux. With ProofKit you add one subscription URL, and Hiddify gets an entry for every node you connect to, over Reality, Hysteria2 or both.

Android · iOS · desktopOne subscription URLReality + Hysteria2Updates itself
Import
One URL
Reality
Yes
Hysteria2
Yes
olcRTC
No

01 /Before you start

You need a ProofKit account (email or Telegram) and at least one active connection to a node. The subscription lists only the nodes you are connected to, so an empty list in Hiddify usually means you have not connected to a node yet.

02 /Step by step

  1. Connect to a node. In the marketplace, pick an exit country and press Connect on a node, or choose a 2-hop route through an entry node.
  2. Pick the right list. In your dashboard, open Subscription URL and set Your app to Happ · Hiddify · V2RayNG. The default option, Ghostlane, gives a link Hiddify cannot import.
  3. Pick the transports. Below the URL, Transports in subscription starts on Reality. Pick All to get a Reality and a Hysteria2 entry for each route, or Hysteria2 for Hysteria2 only.
  4. Copy the URL. Press Copy. The URL contains a secret token, so treat it like a password.
  5. Add it to Hiddify. Tap New profile (+) and choose Add from clipboard. On a computer, use New profile and paste the URL.
  6. Connect. Pick an entry and switch Hiddify on.

03 /What you will see in Hiddify

One entry per route and transport, named after the node: <node> Direct is Reality on a direct route, <node> Direct · Hysteria2 is Hysteria2 on the same route, and a 2-hop route reads <node> via <entry>, where the entry node shows as its country code. When you connect to another node on the website, Hiddify picks it up on its next profile update; update the profile to see it straight away.

04 /Which transports Hiddify runs

  • VLESS Reality: yes, on every platform. See VLESS Reality.
  • Hysteria2: yes, where UDP gets through. See Hysteria2.
  • XHTTP: Hiddify is built on sing-box, which has no XHTTP transport, so whether your build runs it depends on the version. Check Hiddify's own release notes. If XHTTP entries do not connect, keep the filter on Reality or Hysteria2, or use an Xray-core app such as V2RayNG for XHTTP.
  • olcRTC: no. It needs an olcRTC-capable app; see olcRTC.

05 /If it does not work

  • Empty list, or no new entry: connect to a node on the website first, then update the profile in Hiddify.
  • The import fails: check that Your app was set to Happ · Hiddify · V2RayNG before you copied the URL.
  • Connected but nothing loads: try the other transport of the same route, or another node. A session also closes when your balance reaches zero; top up and connect again.
  • The URL leaked: press the regenerate button next to it. The old URL stops working at once; add the new one in Hiddify.

06 /What it costs

Hiddify is free. ProofKit charges per GB: the node's price plus the 20% network fee, locked when you connect and paid from your TON deposit in the escrow contract. Unused balance can be withdrawn.

// faq

Common questions

Does Hiddify support VLESS Reality?

Yes. Hiddify runs VLESS Reality on Android, iOS, Windows, macOS and Linux, and it also runs Hysteria2 from the same ProofKit subscription.

Which link do I copy for Hiddify?

In the dashboard's Subscription URL block, set Your app to Happ · Hiddify · V2RayNG and copy that URL. The Ghostlane option gives a link for an olcRTC app, which Hiddify cannot import.

Why is my list empty?

The subscription lists only the nodes you are connected to. Connect to a node in the marketplace, then update the profile in Hiddify.

Can I switch countries?

Yes. Connect to a node in another country on the website, then update the profile in Hiddify; the new route appears as a new entry.

Can Hiddify run XHTTP or olcRTC?

Not olcRTC: that needs an olcRTC-capable app. XHTTP depends on your Hiddify build, because Hiddify is built on sing-box, which has no XHTTP transport. Check Hiddify's release notes, or keep the filter on Reality or Hysteria2.

Does Hiddify cost anything?

Hiddify itself is free. ProofKit bills per GB: the node's price plus the 20% network fee, paid from your TON deposit.

// ready to try it

Connect a node, then add it to Hiddify

Hiddify shows only the routes you connect to on the website. Pick an exit, connect, and your subscription picks it up. You pay only for the traffic you use.

~/proofkit — your subscription URL
proofkit.org/sub/<token>
# becomes, in Hiddify:
→ <node> Direct
→ <node> Direct · Hysteria2
→ <node> via <entry>