Skip to content
@VPNclient

VPN Client

VPN Client supports multiple protocols: V2Ray, XRay, VMess, VLESS, Shadowsocks, Trojan, SSH, SOCKS5/HTTP/HTTPS proxy.
README.md

VPN Client

🇬🇧 English | 🇷🇺 Русский | 🇹🇭 ไทย | 🇨🇳 中文

VPN Client is a cross-platform VPN client supporting multiple cores and protocols.

🚀 Key Features

  • 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.

🖥️ Supported Platforms

  • ✅ iOS (15.0+)
  • ✅ Android (5.0+)
  • ✅ macOS (Intel/Silicon)
  • ✅ Windows
  • ✅ Unix (Linux/Debian/Ubuntu)

📦 Architecture

VPN Client architecture is structured across several layers:

  1. 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.).

  2. Platform Wrappers:

    • VPNclient-engine-flutter
      Flutter plugin using MethodChannel to interact with native code. Allows using VPNclient-engine in cross-platform Flutter apps.
    • VPNclient-engine-react-native
      React Native wrapper via NativeModules. Provides the same VPNclient-engine integration for React Native apps.

  3. 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]
Loading

⚙️ Supported Protocols

  • VLESS
  • VMess
  • Reality
  • Shadowsocks
  • Hysteria
  • Trojan
  • OpenVPN
  • WireGuard
  • ГОСТ ВПН

⚙️ Supported Cores & Wrappers

🧠 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
Loading

🧦 Supported Proxy Drivers

🧵 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
Loading

📂 Repositories

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

Example Apps

💪 Why VPN Client?

  • 🔧 System-level native integration
  • 🧩 Modular and flexible architecture
  • 💻 Open Source under Extended GPLv3

🛠 Getting Started

Choose the appropriate repository from the list above and follow the instructions in its README.md.

📄 License

Licensed under the Extended GPLv3.
See the LICENSE file for full details.

❤️ Support the Project

Cryptocurrency Donations

Crypto Donations

Network Badge Address
BEP20 BEP20 0x7b2b8f165ce996bef450ed271c17c2e1be67a361
TRC20 TRC20 TCS4bmdr8JFY3bsARce2uX9TE2x724nkES
ERC20 ERC20 0x6dd705576f4867f74eb472f25feed6cfce462ac7
Avalanche AVAX 0x6dd705576f4867f74eb472f25feed6cfce462ac7
Optimism OP 0x6dd705576f4867f74eb472f25feed6cfce462ac7
Arbitrum ARB 0x6dd705576f4867f74eb472f25feed6cfce462ac7
TON TON UQCvoBg8yBYS8m4MGGrwbd-SSrRHqAG6ER_mOITq2ecDL7kI

Traditional Payment Methods

WebMoney

Method Badge Address
VISA Card (International) Visa/MasterCard 4340 7620 0456 8628
MIR Card (Russia) МИР 2200 7015 1277 2515
WebMoney WMZ WMZ Z243626087129
WebMoney WMT WMT T832031273122
WebMoney WMX WMX X699730912499

🙏 Thank You!

📬 Contact

For more information, visit 🌐 vpnclient.click

Pinned Loading

  1. VPNclient-app VPNclient-app Public

    VPN Client Application based on Flutter VPN Client Controller: Xray(VMESS, VLESS, REALITY) + WireGuard

    Dart 36 18

  2. VPNclient-engine-flutter VPNclient-engine-flutter Public

    Flutter wrapper for VPN Client Engine: Xray(VMESS, VLESS, REALITY) + WireGuard

    C++ 14 22

  3. VPNclient-engine-ios VPNclient-engine-ios Public

    Multi-platform wrapper for VPN clients (OS driver + core supporting Sing-box, X-ray, TUIC, Hysteria, Reality, Trojan, SSH etc.)

    Swift 6 1

  4. VPNclient-engine VPNclient-engine Public

    Cross-platform VPN engine core supporting Xray (VMess/VLESS/Reality), WireGuard, OpenVPN, and tun drivers for Android, iOS, Windows, macOS, and Linux.

    Kotlin 7 2

  5. SuperHit-VPNclient-app SuperHit-VPNclient-app Public

    Forked from VPNclient/VPNclient-app

    SuperHit fork of VPN Client Application

    Dart

  6. fineVPN-VPNclient-app fineVPN-VPNclient-app Public

    Forked from VPNclient/VPNclient-app

    fineVPN.org fork of VPN Client Application

    Dart

Repositories

Showing 10 of 16 repositories
  • .github Public

    VPN Client

    VPNclient/.github’s past year of commit activity
    0 0 0 0 Updated May 14, 2025
  • VPNclient-app Public

    VPN Client Application based on Flutter VPN Client Controller: Xray(VMESS, VLESS, REALITY) + WireGuard

    VPNclient/VPNclient-app’s past year of commit activity
    Dart 36 18 7 0 Updated May 12, 2025
  • vpnclient-react-native-app Public
    VPNclient/vpnclient-react-native-app’s past year of commit activity
    TypeScript 0 0 0 0 Updated May 12, 2025
  • VPNclient-green-app Public Forked from VPNclient/VPNclient-app

    VPN Client Application based on Flutter VPN Client Controller: Xray(VMESS, VLESS, REALITY) + WireGuard

    VPNclient/VPNclient-green-app’s past year of commit activity
    Dart 0 23 0 0 Updated May 8, 2025
  • VPNclient-engine-flutter Public

    Flutter wrapper for VPN Client Engine: Xray(VMESS, VLESS, REALITY) + WireGuard

    VPNclient/VPNclient-engine-flutter’s past year of commit activity
    C++ 14 22 2 0 Updated May 8, 2025
  • VPNclient-engine-react-native Public
    VPNclient/VPNclient-engine-react-native’s past year of commit activity
    0 0 0 0 Updated May 5, 2025
  • VPNclient-bot Public
    VPNclient/VPNclient-bot’s past year of commit activity
    1 0 0 0 Updated Apr 29, 2025
  • VPNclient-engine Public

    Cross-platform VPN engine core supporting Xray (VMess/VLESS/Reality), WireGuard, OpenVPN, and tun drivers for Android, iOS, Windows, macOS, and Linux.

    VPNclient/VPNclient-engine’s past year of commit activity
    Kotlin 7 2 0 0 Updated Apr 27, 2025
  • VPNclient-engine-ios Public

    Multi-platform wrapper for VPN clients (OS driver + core supporting Sing-box, X-ray, TUIC, Hysteria, Reality, Trojan, SSH etc.)

    VPNclient/VPNclient-engine-ios’s past year of commit activity
    Swift 6 1 1 0 Updated Apr 13, 2025
  • VPNclient-driver Public
    VPNclient/VPNclient-driver’s past year of commit activity
    C 0 0 0 0 Updated Apr 1, 2025
View all repositories

Most used topics

Loading…