Skip to content

Latest commit

 

History

History
50 lines (31 loc) · 2.59 KB

README.md

File metadata and controls

50 lines (31 loc) · 2.59 KB
Raw

cordova-plugin-tun2socks

This Cordova plugin provides the ability to start a system-wide VPN for Android devices.

We use tun2socks as an adapter; it receives all of the device’s traffic through the VPN network interface (TUN) and forwards it to a SOCKS server.

To handle DNS resoution, we have implemented a local DNS resolver that intercepts DNS queries over UDP and proxies them over TCP (to Google Public DNS) through the SOCKS server.

Re-building the .so

ndk-build -C android

Target Devices

This plugin targets Android devices running Lollipop (API 21), or higher. This requirement stems from calling addDisallowedApplication, a VPNService.Builder API introduced in version 21, which allows the specified application's traffic to bypass the VPN.

Javascript API

start(socksServerAddress:string) : Promise<string>;

Starts the VPN service, and tunnels all the traffic to the SOCKS5 server at socksServerAddress. Restarts tunneling while preserving the VPN connection if called when the plugin is already running.

stop(): Promise<string>;

Stops the VPN service.

onDisconnect(): Promise<string>;

Sets a success callback on the returned promise, to be called if the VPN service gets revoked or disconnected.

deviceSupportsPlugin(): Promise<Boolean>;

Retruns true if the device runs the minimum required version for the plugin to function properly.

Code Sources

We re-use and have used as a starting point open source code from Psiphon, specifically https://github.com/mei3am/ps.

  • src/android:
  • starting point: https://github.com/mei3am/ps/tree/master/Android/app
  • Android/app/src/main/java/ca/psiphon/PsiphonTunnel.java -> src/android/org/uproxy/tun2socks/Tunnel.java
  • Android/app/src/main/java/com/psiphon3/psiphonlibrary/TunnelManager.java -> src/android/org/uproxy/tun2socks/TunnelManager.java
  • Android/app/src/main/java/com/psiphon3/psiphonlibrary/TunnelVpnService.java -> src/android/org/uproxy/tun2socks/TunnelVpnService.java
  • src/badvpn:
  • built upon Psiphon's fork of badvpn.
  • starting point: https://github.com/mei3am/ps/tree/master/Android/badvpn
  • uProxy-specific changes mostly confined to tun2socks/tun2socks.c and marked with // ==== UPROXY ==== (like Psiphon-specific changes)
  • src/android/libs/jsocks.jar:
  • http://jsocks.sourceforge.net/