flutter_v2ray

Table of contents

• Change logs
• Features
• Supported Platforms
• Get started
  • Add dependency
  • Examples
    • URL Parser
    • Edit Configuration
    • Making V2Ray connection
    • Bypass LAN Traffic
    • More
• Credits
• Donation

Change logs

1.0.9

• add disconnect button (notificationDisconnectButtonName)
• fix requestPermission
• fix notification bugs (android 13 and higher)

see more

Features

• Run V2Ray Proxy & VPN Mode
• Get Server Delay
• Parsing V2Ray sharing links and making changes to them

Supported Platforms

Get started

Add dependency

You can use the command to add flutter_v2ray as a dependency with the latest stable version:

$ flutter pub add flutter_v2ray

Or you can manually add flutter_v2ray into the dependencies section in your pubspec.yaml:

dependencies:
  flutter_v2ray: ^replace-with-latest-version

Examples

URL Parser

import 'package:flutter_v2ray/flutter_v2ray.dart';

// v2ray share link like vmess://, vless://, ...
String link = "link_here";
V2RayURL parser = FlutterV2ray.parseFromURL(link);

// Remark of the v2ray
print(parser.remark);

// generate full v2ray configuration (json)
print(parser.getFullConfiguration());

Edit Configuration

// Change v2ray listening port
parser.inbound['port'] = 10890;
// Change v2ray listening host
parser.inbound['listen'] = '0.0.0.0';
// Change v2ray log level
parser.log['loglevel'] = 'info';
// Change v2ray dns
parser.dns = {
    "servers": ["1.1.1.1"]
};
// and ...

// generate configuration with new settings
parser.getFullConfiguration()

Making V2Ray connection

import 'package:flutter_v2ray/flutter_v2ray.dart';

final FlutterV2ray flutterV2ray = FlutterV2ray(
    onStatusChanged: (status) {
        // do something
    },
);

// You must initialize V2Ray before using it.
await flutterV2ray.initializeV2Ray();

// v2ray share link like vmess://, vless://, ...
String link = "link_here";
V2RayURL parser = FlutterV2ray.parseFromURL(link);

// Get Server Delay
print('${flutterV2ray.getServerDelay(config: parser.getFullConfiguration())}ms');

// Permission is not required if you using proxy only
if (await flutterV2ray.requestPermission()){
    flutterV2ray.startV2Ray(
        remark: parser.remark,
        // The use of parser.getFullConfiguration() is not mandatory,
        // and you can enter the desired V2Ray configuration in JSON format
        config: parser.getFullConfiguration(),
        blockedApps: null,
        bypassSubnets: null,
        proxyOnly: false,
    );
}

// Disconnect
flutterV2ray.stopV2Ray();

Bypass LAN Traffic

final List<String> subnets = [
    "0.0.0.0/5",
    "8.0.0.0/7",
    "11.0.0.0/8",
    "12.0.0.0/6",
    "16.0.0.0/4",
    "32.0.0.0/3",
    "64.0.0.0/2",
    "128.0.0.0/3",
    "160.0.0.0/5",
    "168.0.0.0/6",
    "172.0.0.0/12",
    "172.32.0.0/11",
    "172.64.0.0/10",
    "172.128.0.0/9",
    "173.0.0.0/8",
    "174.0.0.0/7",
    "176.0.0.0/4",
    "192.0.0.0/9",
    "192.128.0.0/11",
    "192.160.0.0/13",
    "192.169.0.0/16",
    "192.170.0.0/15",
    "192.172.0.0/14",
    "192.176.0.0/12",
    "192.192.0.0/10",
    "193.0.0.0/8",
    "194.0.0.0/7",
    "196.0.0.0/6",
    "200.0.0.0/5",
    "208.0.0.0/4",
    "240.0.0.0/4",
];

flutterV2ray.startV2Ray(
    remark: parser.remark,
    config: parser.getFullConfiguration(),
    blockedApps: null,
    bypassSubnets: subnets,
    proxyOnly: false,
);

Android configuration before publish to Google Play🚀

gradle.preperties

• add this line

  android.bundle.enableUncompressedNativeLibs = false

build.gradle (app)

• Find the buildTypes block:

  buildTypes {
      release {
          // TODO: Add your own signing config for the release build.
          // Signing with the debug keys for now, so `flutter run --release` works.
             signingConfig signingConfigs.release
      }
  }

• And replace it with the following configuration info:

  splits {
      abi {
          enable true
          reset()
          //noinspection ChromeOsAbiSupport
          include "x86_64", "armeabi-v7a", "arm64-v8a"
  
          universalApk true
      }
  }
  
  buildTypes {
      release {
          // TODO: Add your own signing config for the release build.
          // Signing with the debug keys for now, so `flutter run --release` works.
             signingConfig signingConfigs.release
             ndk {
              //noinspection ChromeOsAbiSupport
              abiFilters "x86_64", "armeabi-v7a", "arm64-v8a"
              debugSymbolLevel 'FULL'
          }
      }
  }

More examples

• Simple v2ray client written in flutter

Credits

badvpn (tun2socks) Copyright (C) Ambroz Bizjak

All rights reserved.

Donation

If you liked this package, you can support me with one of the following links.

Buy me a coffee

Cryptocurrency

• BTC:
  • bc1qrtq0ygmxw7meak3ukvxn03za2j7t7s4uxuujct
• Tron
  • TVQQdim3pxa4XoZyRRVHQ8GsY42rEgB4ow
• USDT
  • TRC20
    • TVQQdim3pxa4XoZyRRVHQ8GsY42rEgB4ow
  • ERC20
    • 0xD5d931BB40F02Ed45172faebD805B3f0ba70Fe73
• DogeCoin
  • DNFaHFzmUfeUB6NFgQX1sLn9q8kknTmKd8