demo

Documentation

Overview

This demo program allows testing the iOS packet forwarding functionality on a desktop machine using a TUN device.

Note - the demo currently doesn't support UDP.

There are two ways to run the demo:

To fetch configuration from the cloud, just like iOS does, run:

./demo -gw 192.168.1.1 -bypassthreads 100

Replace 192.168.1.1 with your default gateway (here and below as well).

The -bypassthreads flag will enable automatic configuration of the routing table to bypass the demo TUN device for traffic to your proxy as well as domain fronting traffic.

Alternately, to point at a specific proxies.yaml, run:

./demo -gw 192.168.1.1 -proxiesyaml ~/proxies.yaml

To have the demo program handle all your internet traffic, run:

sudo route delete default && sudo route add default 10.0.0.2

If using a proxies.yaml, you'll also need to manually set up a direct route for proxy traffic via the default gateway, like so:

sudo route add 67.205.172.79 192.168.1.1

Now your network traffic will route through here to your proxy.

When you're finished, you can fix your routing table with:

sudo route delete default && sudo route add default 192.168.1.1

If you added a manual route for the proxy, you'll want to remove that too:

sudo route delete 67.205.172.79

The utility scripts vpn.bash and direct.bash provide convenient ways to route traffic via the VPN or go back to routing traffic directly. You'll need to change the settings in routes.bash to match your system.