Go to file
2023-04-01 08:10:35 +08:00
.github/workflows Create docker-image.yml 2023-02-22 21:36:59 +08:00
cmd update 2023-03-18 16:43:16 +08:00
docker-compose add 2023-02-22 21:29:12 +08:00
_config.yml add 2023-02-22 21:29:12 +08:00
.gitignore add 2023-02-22 21:29:12 +08:00
client.go move dir 2023-03-18 13:32:35 +08:00
Dockerfile update 2023-02-22 21:36:00 +08:00
gen.bat add 2023-02-22 21:29:12 +08:00
GeoLite2-Country.mmdb add 2023-02-22 21:29:12 +08:00
go.mod update 2023-03-18 16:43:16 +08:00
go.sum update 2023-03-18 16:43:16 +08:00
LICENSE add 2023-02-22 21:29:12 +08:00
msg.pb.go move dir 2023-03-18 13:32:35 +08:00
msg.proto move dir 2023-03-18 13:32:35 +08:00
network.jpg add 2023-02-22 21:29:12 +08:00
pack.sh change 2023-03-18 13:35:27 +08:00
pingtunnel_test.go move dir 2023-03-18 13:32:35 +08:00
pingtunnel.go move dir 2023-03-18 13:32:35 +08:00
README.md Update README.md 2023-03-31 13:38:40 +08:00
server.go move dir 2023-03-18 13:32:35 +08:00

Pingtunnel

Go Report Card

Pingtunnel is a tool that send TCP/UDP traffic over ICMP.

Note: This tool is only to be used for study and research, do not use it for illegal purposes

image

Usage

Install server

  • First prepare a server with a public IP, such as EC2 on AWS, assuming the domain name or public IP is www.yourserver.com
  • Download the corresponding installation package from releases, such as pingtunnel_linux64.zip, then decompress and execute with root privileges
sudo wget (link of latest release)
sudo unzip pingtunnel_linux64.zip
sudo ./pingtunnel -type server
  • (Optional) Disable system default ping
echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all

Install the client

  • Download the corresponding installation package from releases, such as pingtunnel_windows64.zip, and decompress it
  • Then run with administrator privileges. The commands corresponding to different forwarding functions are as follows.
  • If you see a log of ping pong, the connection is normal

Forward sock5

pingtunnel.exe -type client -l :4455 -s www.yourserver.com -sock5 1

Forward tcp

pingtunnel.exe -type client -l :4455 -s www.yourserver.com -t www.yourserver.com:4455 -tcp 1

Forward udp

pingtunnel.exe -type client -l :4455 -s www.yourserver.com -t www.yourserver.com:4455

Use Docker

It can also be started directly with docker, which is more convenient. Same parameters as above

  • server:
docker run --name pingtunnel-server -d --privileged --network host --restart=always esrrhs/pingtunnel ./pingtunnel -type server -key 123456
  • client:
docker run --name pingtunnel-client -d --restart=always -p 1080: 1080 esrrhs/pingtunnel ./pingtunnel -type client -l: 1080 -s www.yourserver.com -sock5 1 -key 123456

Thanks for free JetBrains Open Source license