Skip to content

Using a private proxy link

This page is for you if someone you trust has given you a private proxy link that starts with vless:// and you want to use it. You don’t need to know how it works inside. If you run proxies yourself, read the VLESS / Xray Deployment Guide instead.

The link points to a proxy server running Xray with the VLESS protocol and REALITY. REALITY makes your connection look like ordinary HTTPS to a well-known website, so a censor watching your network sees what looks like normal web browsing. If the censor connects to the server to check it, the server answers like that real website.

A link looks like this. This example is fake and will not connect:

vless://00000000-0000-0000-0000-000000000000@192.0.2.10:443?encryption=none&security=reality&sni=www.example.com&fp=chrome&pbk=EXAMPLE-ONLY-NOT-A-REAL-KEY&type=tcp#example

It holds your personal ID (the long number before @), the server’s address and port, and the settings your app needs. The whole thing is one line. Copy all of it.

Private proxy (this page)Tor with a private bridge
SpeedFast enough for video, calls and big downloadsSlower
Which appsEvery app on the device, once the app is in VPN modeTor Browser, or apps you route through Orbot
Who can see which sites you visitThe person running the proxy, and its internet providerNobody along the way can link you to the sites you visit
Hides who you are from websitesNo, sites see the proxy’s address but can still track your accounts and browserYes, Tor Browser is built for this

Use the proxy when you need to get around a block and keep using your normal apps: messaging, maps, news, video.

Use Tor instead when it matters that nobody can link you to what you do. The proxy hides your traffic from the network you’re on, but the proxy server itself sees your IP address, the addresses of the sites you connect to, when, and how much data. It can’t read content protected by HTTPS, but that metadata alone can say a lot. Only use a proxy run by someone you trust, and ask them what they keep.

Pick one app for your device. The labels below come from each app’s current source code or store listing (checked November 2026). Apps change their menus, so the wording may shift a little.

Before you start, copy the whole link from wherever you received it (for example, long-press the message in Signal and choose Copy).

Hiddify is open source and works on every platform, so it’s the easiest to explain to friends.

  1. Install Hiddify from Google Play or from the GitHub releases (Hiddify-Android-universal.apk).
  2. Open it and tap Add profile (the + at the top of the home screen).
  3. Tap Clipboard. Hiddify reads the link you copied and adds a profile.
  4. Tap the large button that says Tap to connect.
  5. Android asks to set up a VPN connection the first time. Tap OK.
  6. When the button says Connected, every app on the phone goes through the proxy.

v2rayNG is a long-running Android client by the same developer as v2rayN. It’s not on Google Play; get it from its GitHub releases (the universal APK works on any phone).

  1. Open v2rayNG and tap + at the top of the Config screen.
  2. Tap Import from Clipboard. The link appears in the list.
  3. Tap it to select it.
  4. Tap the start button (a play icon) at the bottom of the screen. Android asks to set up a VPN connection the first time; tap OK.
  5. The bar at the bottom shows Connected. Tap to check connection. Tap it: it should report Connection succeeded.

If it says There is no data in the clipboard, copy the link again.

  1. Install Hiddify Proxy & VPN from the App Store.
  2. Tap Add profile (the + at the top), then Clipboard. If iOS asks whether Hiddify may paste, tap Allow Paste.
  3. Tap Tap to connect. The first time, iOS asks to add a VPN configuration: tap Allow and confirm with your passcode or Face ID.
  4. Wait for Connected.

Streisand is a free App Store app (iOS 15 or later). It’s closed source, so these steps come from its store listing and published user guides, not from its code.

  1. Install Streisand from the App Store.
  2. Tap + in the top right corner and choose Import from Clipboard. If iOS asks whether Streisand may paste, tap Allow Paste.
  3. Tap the new profile to connect.
  4. The first time, iOS asks to add a VPN configuration: tap Allow and confirm.
  1. Install Hiddify from the Microsoft Store or the GitHub releases (Hiddify-Windows-Setup-x64.exe).
  2. Click Add profile (+), then Clipboard.
  3. Click Tap to connect and wait for Connected.

If Hiddify says VPN mode can’t start. Relaunch the app as administrator or change service mode, either run it as administrator, or open Settings, set Service mode to Set system proxy, and connect again. System proxy mode covers your browser and most apps, but not all of them.

v2rayN is the desktop version of v2rayNG. It needs Windows 10 or later.

  1. Download v2rayN-windows-64.zip from the GitHub releases (v2rayN-windows-arm64.zip on an ARM laptop), unzip it into a folder, and run v2rayN.exe. See the project’s release files guide if you’re unsure which file to take.
  2. Open the Configuration menu and click Import Share Links from clipboard (or press Ctrl+V in the main window).
  3. Select the new entry, right-click it and choose Set as active (or press Enter).
  4. In the System proxy list at the bottom of the window, choose Set system proxy.
  5. To check it, right-click the entry and choose Test real delay: a number in milliseconds means it works. When you’re done, choose Clear system proxy.
  1. Install Hiddify Proxy & VPN from the Mac App Store (Apple silicon Macs), or Hiddify-MacOS.dmg from the GitHub releases.
  2. Click Add profile (+), then Clipboard.
  3. Click Tap to connect. The first time, macOS asks to add a VPN configuration: click Allow and enter your password.
  4. Wait for Connected.

“Connected” in the app only means the app is running. These checks show that your traffic really goes through the proxy. Do the first two every time you set up a new device; the rest take a minute more.

  1. Write down your normal address first. With the app off, open ipinfo.io. Note the IP address, city and the org line (your internet provider).
  2. Connect, then reload the page. The IP address and org should change to something that isn’t your provider, often in another country. If nothing changes, your traffic isn’t going through the proxy: check that the app says Connected, and that it’s in VPN mode rather than system proxy mode.
  3. Open something that was blocked. If it loads, the proxy is doing its job.
  4. Check DNS. Open dnsleaktest.com and run the Standard test. None of the servers listed should belong to your own internet provider. If they do, the sites you visit can still be seen (and blocked) by your network. Switch the app to VPN mode and test again.
  5. Check WebRTC (computers especially). Open browserleaks.com/webrtc. Your real IP address from step 1 must not appear anywhere on the page. If it does, use VPN mode, or turn off WebRTC in your browser.
  6. Turn it off once. Disconnect and reload ipinfo.io: you should see your own address again. This proves the change in step 2 came from the proxy.

If a check site doesn’t load at all while you’re connected, try another “what is my IP” page. Some networks block these sites too.

The apps also have quick checks of their own:

  • v2rayNG: tap the bar at the bottom; it should say Connection succeeded.
  • v2rayN: right-click the entry and choose Test real delay; a number in milliseconds means it works.
  • Terminal on a Mac: curl --socks5-hostname 127.0.0.1:10808 https://ipinfo.io/json (see Private proxy on a Mac without an app).

The same link works on all your devices at the same time: your phone, your tablet and your laptop.

  • Send the Signal bot !vpn get <device> for each one (for example !vpn get iphone, then !vpn get windows). You get the same personal link each time, with the setup steps for that device.
  • Import it into the app on each device, and do the checks above on each one.
  • If you lose a device, or it’s taken, ask an admin to replace your link. The old link then stops working everywhere, so import the new one on your other devices.

IrregularChat members can also get a subscription link: an https:// address that your app checks every few hours to fetch your current private link. Send the Signal bot !vpn sub <device> in a direct message (for example !vpn sub iphone). It works once your Signal is linked to your IrregularChat account, and the bot sends the steps, then the subscription link on its own.

Why it’s better than the plain link: when your private link is replaced, moved to another server or changed in any other way, an app that uses the plain vless:// link stops working until you import the new one on every device. An app that uses the subscription link picks up the change by itself within a few hours. You add it once.

Add it to one app per device, the same way on each:

  • Hiddify (Android, iPhone, iPad, Mac, Windows, Linux): copy the subscription link, tap Add profile (+), then Clipboard. Hiddify sees that it’s a web address and adds a profile that updates itself (every 6 hours, as the link asks). To update now, use Update profile on that profile.
  • v2rayNG (Android): copy the link, tap +, then Import from Clipboard. It adds the link as a subscription and fetches it. Automatic updates are off by default: open Subscriptions from the side menu, edit the new subscription, turn on Enable automatic update, and save. Update subscription fetches it by hand.
  • v2rayN (Windows): open the Subscription Group menu, then Subscription group settings, and click Add. Type a name under Remarks, paste the link into URL (optional), set Automatic update interval (minutes) to 360, and save. Then choose Subscription Group → Update subscriptions without proxy, select the new entry and Set as active.
  • Streisand (iPhone, iPad, Apple-silicon Mac): copy the link, tap +, then Import from Clipboard. Streisand is closed source, so this comes from published guides, not its code.

If you added the plain vless:// link to the same app before, delete that profile, so the app doesn’t connect with an old copy.

When the link can’t give your app a working configuration (for example while your link is being replaced), the app’s update fails and it keeps the last one that worked. Try again in a few minutes. Hiddify may list a subscription whose updates keep failing under Remove inactive subscriptions; don’t remove it unless you’ve stopped using it.

The subscription link is as private as your proxy link: anyone who has it gets your proxy, and keeps getting it. !vpn reset replaces both. Your old subscription link stops working at once, the bot says so, and you send !vpn sub again for the new one, then replace it in the app on each device.

The link works like a key: anyone who has it can use the proxy as you.

  • Don’t post it or forward it. Not in a group chat, a screenshot or a public paste. If a friend needs one, ask the person who gave you yours to make them their own.
  • Censors block links they find. Once a link appears somewhere public, assume the server will be blocked for everyone who uses it.
  • One link per person. Each link carries its own ID. If one leaks, the operator can turn off that one ID and give you a new link without breaking anyone else’s.
  • Keep it in a private note or password manager, not in your camera roll. If your phone might be searched, delete the message once the app has imported it.
Likely causeWhat you’ll noticeWhat to do
The link was copied wrongThe app won’t import it, or says the clipboard is emptyCopy it again as one unbroken line
Your link was turned offImports fine, never connects, while others still canAsk the person who gave it to you for a new link
The server was blocked or is downWorked before; now connects but no sites loadAsk for a new link; meanwhile use Tor with Snowflake
Your device clock is wrongNever connects, even on an open networkSet date, time and time zone to automatic, then reconnect
Another VPN is runningThe app says another VPN is activeTurn off the other VPN, then connect again
The app is out of dateErrors after the operator updated the serverUpdate the app, then import the link again

Recent changes

  1. feat(signal-bot): !vpn sub sends a subscription URL that keeps the private link current @sac
  2. docs(privacy): travel and shutdown prep pages; bot travel, multi-device and onion lines @sac
  3. docs(wiki): private proxy on a Mac without an app, and how to check it works @sac
  4. feat(irregularnet): members request a private bridge or proxy from the Wi-Fi portal @sac