pingtun is a new implementation of ICMP tunnel which aims for usability and simplicity.

In short, it tunnels ipv4 traffic over icmp echo requests and replies (pings). Thus, bypassing badly configured firewalls and captive portals.

pingtun focus is real-world use, not POC. It tries to implement only features which make it easy to set up, maintain and use. It intentionally does not implement features which are better taken care of by other tools, such as authentication and encryption.

• no need to configure iptables/proc/tun/anything
• peer-to-peer and client-server mode
• periodic echo requests (bypass firewalls which prevent unsolicited replies)
• echo request timer adjustments according to congestion
• reply to non-tunneling pings
• DNS resolution
• single-threaded event driven architecture
• user-space zero copy

• libevent2
• tun driver
• linux socket filter

cmake .
make
sudo make install

on the server:

sudo pingtun 10.9.0.1 255.255.255.252

on the client:

sudo pingtun --client-only --server $SERVER 10.9.0.1 255.255.255.252

• GNU/Linux
• [FUTURE] android
• [FUTURE] mac (client only)