VPN Client is a cross-platform VPN client supporting multiple cores and protocols.
- Multi-protocol support: Xray (VMess, VLESS, Reality, Shadowsocks, Trojan, SSH), OpenVPN, WireGuard, as well as SOCKS5/HTTP/HTTPS proxy.
- Cross-platform: Available for iOS, Android, macOS, Windows, and Linux.
- High performance: Native functionality implemented in Swift (iOS) and Kotlin (Android), and critical components written in C++ and Golang ensure speed and stability.
- ✅ iOS (15.0+)
- ✅ Android (5.0+)
- ✅ macOS (Intel/Silicon)
- ✅ Windows
- ✅ Unix (Linux/Debian/Ubuntu)
VPN Client architecture is structured across several layers:
-
VPNclient-engine
The core engine for various platforms. Handles VPN setup and management, traffic routing, OS integration, and communication with VPN protocols (OpenVPN, WireGuard, Xray, etc.). -
Platform Wrappers:
- VPNclient-engine-flutter
Flutter plugin usingMethodChannelto interact with native code. Allows using VPNclient-engine in cross-platform Flutter apps. - VPNclient-engine-react-native
React Native wrapper viaNativeModules. Provides the same VPNclient-engine integration for React Native apps.
- VPNclient-engine-flutter
-
VPN Client App
A Flutter-based application utilizing the wrappers to manage VPN sessions and display connection status.
Architecture Diagram(click to expand)
graph TD
style A fill:#f9d5e5
A[VPNclient App] --> Z{UI Framework}
Z -->|Flutter| B[Flutter Plugin]
Z -->|React Native| C[React Native Plugin]
Z -->|Native| D[Swift/Kotlin/C++]
style B fill:#eeac99
style C fill:#eeac99
style D fill:#eeac99
B --> E[VPNclient Engine]
C --> E
D --> E
style E fill:#fbc4ab
E --> F[iOS]
E --> G[Android]
E --> H[macOS]
E --> I[Windows]
E --> J[Linux]
- VLESS
- VMess
- Reality
- Shadowsocks
- Hysteria
- Trojan
- OpenVPN
- WireGuard
- 🔌 Xray Core via:
- VPNclient Xray Wrapper
- libXray Wrapper
- sing-box Wrapper
- 🔐 OpenVPN Core
- ⚡ WireGuard Core
🧠 Core Support Diagram (click to expand)
graph TD
style A fill:#fbc4ab
A[VPNclient Engine] --> B{Cores}
style B fill:#fef9c3
%% Wrappers
B --> C[VPNclient Xray Wrapper]
B --> D[libXray Wrapper]
B --> E[sing-box Wrapper]
style C fill:#a0c4ff
style D fill:#a0c4ff
style E fill:#a0c4ff
%% Xray Core
C --> H[Xray Core]
D --> H[Xray Core]
E --> H[Xray Core]
style H fill:#a0c4ff
%% Xray Protocols
H --> H1[VLESS]
H --> H2[VMess]
H --> H3[Reality]
H --> H4[Shadowsocks]
H --> H5[Hysteria]
H --> H6[Trojan]
style H1 fill:#a0c4ff
style H2 fill:#a0c4ff
style H3 fill:#a0c4ff
style H4 fill:#a0c4ff
style H5 fill:#a0c4ff
style H6 fill:#a0c4ff
%% OpenVPN Core
B --> F[OpenVPN Core]
F --> F1[OpenVPN]
style F fill:#d0f4de
style F1 fill:#d0f4de
%% WireGuard Core
B --> G[WireGuard Core]
G --> G1[WireGuard]
style G fill:#ffc6ff
style G1 fill:#ffc6ff
- 🧦 VPN Client Driver
- 🧦 hev-socks5-tunnel
- 🧦 tun2socks
- 🧦 WinTun
🧵 Proxy Driver Diagram (click to expand)
graph TD
style A fill:#fbc4ab
A[VPNclient Engine] --> B{Proxy }
style B fill:#fef9c3
B --> C[VPN Client Driver]
B --> D[hev-socks5-tunnel]
B --> E[tun2socks]
B --> F[WinTun]
style C fill:#caffbf
style D fill:#a0c4ff
style E fill:#ffc6ff
style F fill:#ffd6a5
| Component | Repository |
|---|---|
| 🌐 VPN Client App (Flutter) | VPNclient-app |
| 📱 VPN Client Engine (Flutter Plugin) | VPNclient-engine-flutter |
| 📱 VPN Client Engine (React Native Plugin) | VPNclient-engine-react-native |
| 🤖 VPN Client Engine | VPNclient-engine |
- 🔧 System-level native integration
- 🧩 Modular and flexible architecture
- 💻 Open Source under Extended GPLv3
Choose the appropriate repository from the list above and follow the instructions in its README.md.
Licensed under the Extended GPLv3.
See the LICENSE file for full details.
For more information, visit 🌐 vpnclient.click
