This project helps bypassing restrictive censorship environments that block direct TCP or UDP connections, by setting up ICMP, ICMP6, DNS or DNS over UDP6 tunnels. It has the same aim as icmptx, iodine, ozzyman DNS, nstx etc.
It automatically patches TCP MSS option to achieve a non-fragmented stream of packets (known as MSS-clamping).
It also uses MD5 to (HMAC-)integrity protect the tunnel from evil injected TCP packets. If you need privacy, you have to use encryption yourself. Its assumed that you use SSH over the tunnel anyways. (Either directly or with the SSH proxy option if you need HTTP tunneled.)
fraud-bridge also uses EDNS0 extension headers to put as many bytes into
the TXT reply as possible. In my tests, as it tries to answer any timing
packets, it produces no logs in a bind9 system log-file. If you change
the EDNS0 (-E), you need to do it on both ends with the same value.
(As inside announces maximum UDP payload size to the nameserver and outside
endpoint calculates the MSS from that what was given with -E.)
fraud-bridge also includes some other techniques to cope with certain bind limitations, e.g. quotas/limiting.
Please also note that c->skills is providing the full chain of
censorship fucking equipment you may be interested in:
Basically you just do make on Linux.
The usage is as follows:
fraud-bridge -- https://github.com/stealth/fraud-bridge
Usage: ./fraud-bridge <-k key> [-R IP] [-L IP] [-pP port] [-iIuU]
[-E sz] [-d dev] [-D domain] [-S usec] [-X user] [-r dir] [-v]
-k -- HMAC key to protect tunnel packets
-R -- IP or IPv6 addr of (outside) peer when started inside
-L -- local IP addr to bind to if started outside (can be omitted)
-p -- remote port to use if in DNS mode (default: 53)
-P -- local port to use if in DNS mode (outside default: 53)
-i -- use ICMP tunnel
-I -- use ICMPv6 tunnel
-u -- use DNS tunnel over IP
-U -- use DNS tunnel over IPv6
-E -- set EDNS0 size (default: 1024)
-d -- tunnel device to use (default: tun1)
-D -- DNS domain to use when DNS tunneling
-S -- usec slowdown for DNS ping (default: 5000)
-X -- user to run as (default: nobody)
-r -- chroot directory (default: /var/empty)
-v -- enable verbose mode
Some definitions: inside refers to the machine inside the censored network, most likely your laptop/PC. outside refers to a VPS or machine outside the censored network, i.e. what people call "free internet".
After start, fraud-bridge opens a point-to-point tunnel: 1.2.3.4 <-> 1.2.3.5
Then you need to start inside.sh on the inside and outside.sh outside.
Looks like so:
On outside end of tunnel (e.g. a server at the internet):
# ./fraud-bridge -u -L 192.168.2.222 -D f.sub.dnstunnel.com -k key
(and starting outside.sh)
And inside:
# ./fraud-bridge -u -R 127.0.0.1 -D f.sub.dnstunnel.com -k key
(and starting inside.sh)
as an example for a DNS tunnel with a local 127.0.0.1 named running and
the outside peer being at 192.168.2.222. As said, outside part of
tunnel can (and actually needs to) be started beforehand and will just
listen for the peer to open the tunnel. Example zone-files are included if
you want to experiment with your own bind setups. For running ITW tunnels
they are not necessary.
The default tunnel device is tun1. Make sure to not run multiple instances of
fraud-bridge at the same time or any other tunnel software that is using this
tunnel device. After each kill/restart of fraud-bridge daemon you have to execute the
inside/outside scripts again at the particular end where you restarted it.
The -L parameter at outside can (should) be omitted. In real setups the -R parameter
on inside setups contains the IP or IP6 address of the outside server, or if
DNS recursion is used, the IP address of the DNS server of your provider or
public recursive DNS resolver. If you do not have your own DNS server,
you can still use DNS tunneling by using your VPS IP as -R parameter
on inside and using any (but the same) -D domain paramater on both ends
that look legit for an censorship regime, e.g. -D blah.gov.
Before trying DNS tunneling, you should most likely try with ICMP tunneling.
If you see chroot warnings in the syslog, you can ignore them or provide
valid arguments to -r.
You can then use ssh -x -v 1.2.3.5 to get a SSH connection to 192.168.2.222
in above example and use the SSH proxy options to setup a web browser environment that runs
across the tunnel.
You can also do that with ICMP: -i and ICMP on IPv6: -I or DNS on UDP via
IPv6: -U.
It's also possible to switch tunnel from DNS to ICMP beyond your SSH connection,
as the TCP state is kept in local and remote kernel and not in the bridge.
In verbose mode, fraud-bridge will leave stdout open for reporting errors or messages,
so you need to run it on a screen or redirect output to /dev/null if you need
it running in (verbose) background. Keep that in mind since you need to start the inside/outside
scripts after invoking fraud-bridge. If not using -v, it goes to background and logs
errors to syslog.
Before using any ICMP tunnels, make sure to relax your cable-modem's firewalling rules in order to receive the reply packets from your remote peer. fraud-bridge works behind NAT, but it needs to receive the reply packets at last.
Since fraud-bridge opens a PtP tunnel, it can strip the IP header off the packets that it transmits and synthesize it at each end. So for ICMP tunneling you just have an overhead of 8 (ICMP) + 16 (HMAC) bytes, which is acceptable. DNS tunneling has still good latency and bandwidth when doing directly, thanks to MSS clamping. When tunneling indirectly via public DNS resolvers, the default values are good enough to have a reasonable session, but of course ICMP tunneling is to prefer whenever possible.
By using ssh -D [0.0.0.0]:1234 1.2.3.5 you can setup a local SOCKS proxy on your machine
port 1234 (inside) and distribute it via WLAN to your neighborhood for censorship-free web sessions.
You may also setup a local tor on the outside box, offering a SOCKS port on 127.0.0.1:9150
as you normally do and then using ssh -L 9150:127.0.0.1:9150 1.2.3.5 to forward this outside
port to your inside machine, so to exactly mirror the outside tor setup locally and distribute it
as tor SOCKS port via WLAN to your users. This way we do not need to implement pluggable transports
and you can still use tor as before. The same also works with crash or psc sessions or any other
tunneling mechanism.
The -S parameter has a reasonable default value for the DNS timer packets that need to be sent
to the server in constant interval. Lower values give a better tunnel latency but may overload
the recursive DNS server and produce more noise.
proudly sponsored by:
