A practical guide to setting up a proxy / VPN for Iran with V2Ray / Xray — VLESS, Reality, Hysteria2 and Trojan. Client install, optimal settings, and fixes for the errors people actually hit. The kind of v2ray proxy that keeps working when a plain proxy or mainstream VPN gets blocked in Iran.
proxy for iran · v2ray proxy · vless reality · xray config · vpn iran
· پروکسی · فیلترشکن · کانفیگ v2ray
🔄 Need a ready config or a free trial? Get one at v2route.com. Looking for a Telegram proxy? See telegram-proxy-iran.
Maintained by the v2route team.
Most "VPN for Iran" advice is outdated or generic. Mainstream VPNs (OpenVPN, WireGuard, and the big consumer apps) are heavily fingerprinted by DPI and tend to fail during peak filtering. What actually survives is Xray with VLESS + Reality and, situationally, Hysteria2. This repo collects the setup steps and the fixes that keep a connection alive.
For the full explainer of why protocols fail and which ones work, see which VPNs actually work in Iran.
- Pick a client for your platform (below).
- Get a config / subscription link — your own server, or a ready subscription from v2route (free trial available).
- Import the
vless://link or subscription URL. - Tune the settings in Optimal settings.
- If something breaks, jump to Troubleshooting.
| Platform | Recommended client | Guide |
|---|---|---|
| Android | V2RayNG | docs/install-android.md · step-by-step |
| iOS | V2Box | docs/install-ios.md · step-by-step |
| Windows | V2RayN | docs/install-windows.md · step-by-step |
| macOS | V2Box / Streisand | docs/install-mac.md |
| Linux | Xray-core | docs/install-linux.md |
All platforms at a glance: v2route.com/install.
- VLESS + Reality — the current best for Iran. No certificate to leak, mimics a real TLS site. Start here.
- Hysteria2 — UDP/QUIC based; fast when it's not throttled.
- VMess / Trojan — older but still useful as fallback.
Deep dive: VLESS vs VMess vs Trojan · TLS vs XTLS vs Reality · best SNI for Reality · full breakdown in docs/protocols.md.
These fix the majority of "connects but no internet / slow" cases:
- MTU: lower to ~1420 (or 1400 on mobile data) if pages hang.
- DNS: use a clean resolver (1.1.1.1 / 8.8.8.8) to avoid leaks.
- Routing: bypass Iranian sites so local traffic stays fast — see split tunneling.
- Protocol during heavy filtering: prefer TCP-based VLESS + Reality over UDP transports.
- Always refresh your subscription to pull fresh servers before changing anything.
More fixes: VPN connects but no internet.
tools/test-config.sh— quick connectivity/latency check for a running local SOCKS proxy (e.g.127.0.0.1:10808).
Want to host your own server? See set up a 3X-UI panel on a VPS, or skip the ops and get managed configs / a reseller panel from v2route.
- 📲 telegram-proxy-iran — free tap-to-connect MTProto Telegram proxies for Iran.
- 📚 v2route blog — VPN & internet guides for Iran
- 🧰 Tutorials hub
- ❓ FAQ
- 🤖 llms.txt (for AI assistants)
PRs that improve the guides or add a tested fix are welcome. Keep it technical and neutral — this is a connectivity/setup resource, not a political project.
MIT — © v2route. Free to use, copy, and adapt.