ikev2 #

A powerful Flutter plugin to setup and control IKEv2 VPN connections using the strongSwan protocol.

ikev2 provides a robust API to manage VPN connections with full support for IKEv2 EAP and PSK authentication methods on Android.

Developed by Orban InfoTech.

Key Features #

• 🚀 Android Support: Native implementation using strongSwan for high performance.
• 🍎 iOS Support: Available as a premium add-on (NetworkExtension).
• 📊 Traffic Statistics: Real-time download/upload speed and total data usage monitoring.
• 🔐 Secure Authentication: Supports both IKEv2 EAP and PSK methods.
• 🔔 Notification Support: Integrated native foreground service with status notifications.
• ⚡ Connectivity: Automatic handling of network state changes.

🍎 iOS Support (Premium) #

This package on pub.dev provides full Android support.

iOS support (using NetworkExtension) is available as a commercial add-on. If you require the iOS implementation or the complete cross-platform source code, please contact me directly:

👉 Contact via Telegram: Click Here to Buy

Installation #

Android #

Modify your android/app/build.gradle to use abiFilters. This ensures that the correct native libraries are included for each architecture, as Flutter doesn't fully handle this for native .so files automatically yet.

android {
    ...
    buildTypes {
        ...
        release {
            ...
            ndk {
                if (!project.hasProperty('target-platform')) {
                    abiFilters 'arm64-v8a', 'armeabi-v7a', 'x86_64'
                } else {
                    def platforms = project.property('target-platform').split(',')
                    def platformMap = [
                            'android-arm'  : 'armeabi-v7a',
                            'android-arm64': 'arm64-v8a',
                            'android-x86'  : 'x86',
                            'android-x64'  : 'x86_64',
                    ]
                    abiFilters = platforms.stream().map({ e ->
                        platformMap.containsKey(e) ? platformMap[e] : e
                    }).toArray()
                }
            }
        }
    }
}

The plugin will automatically download pre-built native libraries from GitHub if they haven't been downloaded during the build process.

Usage #

1. Initialize & Prepare #

Before starting a connection, especially on Android, you must prepare the VPN service. This triggers the system's VPN permission dialog if not already granted.

import 'package:ikev2/ikev2.dart';

void initVpn() async {
  // Check if VPN permission is granted
  bool prepared = await IkeV2.prepared;

  if (!prepared) {
    // Request VPN permission
    prepared = await IkeV2.prepare();
  }
}

2. Connect #

You can establish a connection using either EAP (Username/Password) or PSK (Pre-Shared Key).

Connect with IKEv2 EAP

void connect() async {
  await IkeV2.connectIkev2EAP(
    server: "vpn.example.com",
    username: "your-username",
    password: "your-password",
    name: "Orban VPN", // Visible Name in Notification
    // Optional
    remoteId: "optional-remote-id",
    localId: "optional-local-id",
    mtu: 1400,
    port: 500, // Default is usually 500 or 4500
    disableCertValidation: false, // Set to true for self-signed certs (dev only)
  );
}

Connect with IKEv2 PSK

void connectPsk() async {
  await IkeV2.connectIkev2Psk(
    server: "vpn.example.com",
    username: "your-username", // Used as identity if required
    password: "your-pre-shared-key", // PSK
    remoteId: "vpn.example.com",
    localId: "client-id",
    name: "Orban VPN",
  );
}

3. Disconnect #

Stop the VPN service and disconnect.

void disconnect() async {
  await IkeV2.disconnect();
}

4. Listen to Status & Traffic #

Monitor connection state and real-time traffic statistics.

Connection Status:

IkeV2.onStateChanged.listen((state) {
  print("VPN Status Changed: $state");
  // States: connecting, connected, disconnecting, disconnected, error, etc.
});

Traffic Statistics:

To receive traffic updates, start the traffic monitor (usually after connection).

// Start monitoring
IkeV2.startTrafficMonitor();

IkeV2.onTrafficChanged.listen((stats) {
  print("Download Speed: ${stats.downloadSpeed} B/s");
  print("Upload Speed: ${stats.uploadSpeed} B/s");
  print("Total Download: ${stats.totalDownload} bytes");
  print("Total Upload: ${stats.totalUpload} bytes");
  print("Duration: ${stats.duration} seconds");
});

VPN Stages #

Supported Platforms #