IP Over Proto

This project allows you to tunnel IPv4 traffic over 4 different transports (in order of lowest preference to highest).

1. DNS
2. ICMP
3. TCP
4. UDP

Building

The first step is to build the binaries. They client and server binaries will live at ./bin/iop-client and ./bin/iop-server respectively.

# Use this to build both client and server
make

# Build only the client
make client

# Build only the server
make server

You have the choice of manually installing the binary, or automatically installing.

make install

Automatic installation will place one or both projects, depending on if you built both, into your bin folder, with the names iop-client and iop-server.

Starting the client

The following options are available when starting the client:

• --no-daemonize - By default, the client daemonizes after initialization. This flag disables that
• -address [IPv4 address] - Specifies the server to connect to
• --force-dns - Forces the client to either tunnel over DNS (port 53) or abort the connection
• --force-icmp - Forces the client to either tunnel over ICMP or abort the connection
• --force-tcp - Forces the client to either tunnel over TCP (port 443) or abort the connection
• --force-udp - Forces the client to either tunnel over UDP (port 9191) or abort the connection

For example, to start a background instance of the client that connects to a server at 1.2.3.4 over DNS, you could use

iop-client -address "1.2.3.4" --force-dns # DNS implies port 53

Starting the server

The following options are available when starting the server:

• --no-daemonize - By default the server daemonizes after initialization. This flag disables that
• -bind [address] - By default the server binds to 0.0.0.0. This option will override that behavior
• -transports [protocol list] - A comma-delimited list (no spaces) of transports that the server should support. By default, the server supports all of them. This option can be used to reduce that list

For example, to start a server that listens on 1.2.3.4 and only accepts connections over DNS or ICMP, you could use

iop-server -address "1.2.3.4" -transports "dns,icmp"