Free · Cross-platform · Works on iOS, macOS, Android, Windows

v2RayTun — Install guide

Platform: Android · iOS · macOS · Windows

Why v2RayTun

v2RayTun is a cross-platform VLESS/Xray client by DATABRIDGES Technologies. It's one of the few free clients that ships on iOS, macOS, Android, and Windows with the same UI and config format, so a single QR code from your Store4Gateway dashboard works everywhere. Popular choice if you use multiple devices.


Step 1 — Get the app

You can download v2RayTun directly from this site (we mirror the unmodified, upstream-signed binaries from the official GitHub release) or get it from the App Store / Google Play.

iOS and macOS

  • App Store (v2RayTun) — single listing covers iPhone, iPad, and Apple-Silicon Macs
  • Requires iOS 16+ / macOS 13+
  • Apple platforms only allow App Store installs, so there is no direct download

Android

The GitHub APK and the Google Play version differ slightly: the sideloaded APK disables SSL pinning on its update check, which is sometimes the deciding factor in restricted regions. Both speak the same VLESS+Reality configs.

Windows


Step 2 — Import your Store4Gateway access key

Option A — Scan the QR code (recommended on mobile)

  1. Log in to store4gateway.com/dashboard on another device (laptop, second phone).
  2. Open v2RayTun → tap the + (plus) icon.
  3. Choose Scan QR code.
  4. Scan the QR code on the dashboard.

Option B — Paste the VLESS URL from clipboard

  1. On the dashboard, click Copy URL.
  2. In v2RayTun, tap +Import from clipboard (or Add from URL).
  3. The server appears in your profile list.

Step 3 — Connect

  1. Tap the imported server row to select it (a check / highlight appears).
  2. Tap the large connect switch at the top of the screen.
  3. Accept the VPN / network permission prompt (first time only).
  4. The switch turns green when the tunnel is up.

Step 4 — Verify

Open store4gateway.com/check in your browser.

You should see "✓ You're connected via our proxy". If not, toggle the connection off/on and re-check.


Troubleshooting

"Invalid config" or "parse error" on import

  • Make sure you copied the full vless://... URL end-to-end. The URL already contains server, port, UUID, and Reality parameters — do not edit anything by hand.

Connects but websites don't load

  • On iOS: Settings → VPN → make sure v2RayTun is the active VPN configuration. Other VPN apps can hijack the default.
  • On Android: Settings → Network → VPN → confirm v2RayTun is active.

Play Store version won't update

  • Occasionally Google Play delays v2RayTun updates in some regions. Uninstall and reinstall using the direct APK if the Play Store build is stuck on an old version.

macOS: "v2RayTun is damaged and can't be opened"

  • You downloaded the iOS app on Apple Silicon — this message means the app bundle wasn't signed for macOS distribution outside the App Store. Install via the App Store link instead.

Still stuck? Contact support.

After setup, verify your connection at store4gateway.com/check.

Still stuck? Contact support.