Git Product home page Git Product logo

vpn-reverse-tether's Introduction

VPN-based USB "reverse tether"

Reverse tethering routes traffic from the device via host gateway over USB. This allows the Android device to access the network through the host without depending on Wifi or Bluetooth.

This method leverages VpnService API and does not require root access.

Technical details

+-----------------------+                  +------------------------+
|    Android Device     |                  |       Linux Host       |
|-----------------------|                  |------------------------|
|                       | Android          |                        |
|         ^ iptables    | VpnService       |          ^ iptables    |
|         |             |                  |          |             |
|     +--------+        |                  |      +--------+        |
|     |  tun   |  ---------                |      |  tun   |  ---------
|     +--------+        |  \               |      +--------+        |  \
|         ^             |                  |          ^             |
|         | forward()   | TetherService    |          | forward()   | forwarder
|         v             |                  |          v             |
|    +----------+       |  /               |   +---------------+    |  /
|    | unix sock| ---------                |   | TCP/unix sock | ------
|    +----------+       |                  |   +---------------+    |
|         |             |                  |          |             |
|         |             |                  |          |             |
|     +--------+        |                  |      +--------+        |
|     |  adbd  |        |                  |      |  adb   |        |
|     +--------+        |                  |      +--------+        |
|         +             |                  |          +             |
|         |             |                  |          |             |
+---------|-------------+                  +----------|-------------+
          |                                           |
          |                                           |
          |     adb forward XXX localabstract:YYY     |
          +-------------------------------------------+

Installation

ant

  1. Get Android SDK and NDK. Using the SDK manager, get build tools.

  2. Build the native library:

     $(ANDROID_NDK)/ndk-build
    
  3. Build the apk and install it:

     ANDROID_HOME=$(ANDROID_SDK) ant debug install
    
  4. Build the host-side forwarder:

     make -C jni
    

Eclipse

  1. Get Android Development Tools and Android Native Development Tools.

  2. Import existing project into workspace and build.

  3. Build the host-side forwarder:

     make -C jni
    

Usage

  1. Start the VPN service:

     ./run.sh setup  # You will be asked for sudo password.
    

    Wait for the alert dialog.

  2. Start the tunnel:

     ./run.sh run  # You will be asked for sudo password.
    

    You should see a key icon in the status bar.

  3. When done, press Enter to stop the tether.

License

See LICENSE.

vpn-reverse-tether's People

Contributors

szym avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

vpn-reverse-tether's Issues

Working of traffic flow from android device to host

This is not an issue but more of a query for understanding purpose. I did read around networking rules but still could not figure out completely due to missing pieces. Everything works perfectly but wish to understand what is the command exactly that's helping in directing the traffic from android device to host especially because I do not see any adb reverse command being used.

  1. Once VpnService intercepts a request, via file descriptors the packets are being written to ANDROID_SOCK.
  2. Is the ANDROID_SOCK responsible to pass the packet directly to host just because an adb forward tunnel (from host to device) is already created?
  3. On doing tcpdump on host side, I actually see request originating from different ports. Is the file descriptor of ANDROID_SOCK communicating with these ports or the VpnInterface?
  4. On seeing other vpn setups, I see peer (host in this case) also being mentioned if one tries to check ip addr show dev tun0 on android device. I do not see such peer being mentioned in this setup. It only shows this inet 10.0.0.2/32 scope global tun0 with no mention of peer.

P.S. Apologies as this might not be the right forum for the question. But would be grateful if anybody could help.

Unix mode connection not working

adb forward /tmp/vpntether localabstract:vpntether
error: cannot bind to socket: Resource temporarily unavailable

Means that /tmp/vpntether is not created. When trying to use this tool:

Connect to tunnel: No such file or directory

I've trying switching to TCP mode. But those not working on my 4.4 Kitkat device, but on 5.0.1 is working.
No idea why...

Could some one more experienced help me solve my issues?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.