76 lines
2.9 KiB
Markdown
76 lines
2.9 KiB
Markdown
# Pingtunnel
|
|
|
|
[<img src="https://img.shields.io/github/license/esrrhs/pingtunnel">](https://github.com/esrrhs/pingtunnel)
|
|
[<img src="https://img.shields.io/github/languages/top/esrrhs/pingtunnel">](https://github.com/esrrhs/pingtunnel)
|
|
[](https://goreportcard.com/report/github.com/esrrhs/pingtunnel)
|
|
[<img src="https://img.shields.io/github/v/release/esrrhs/pingtunnel">](https://github.com/esrrhs/pingtunnel/releases)
|
|
[<img src="https://img.shields.io/github/downloads/esrrhs/pingtunnel/total">](https://github.com/esrrhs/pingtunnel/releases)
|
|
[<img src="https://img.shields.io/docker/pulls/esrrhs/pingtunnel">](https://hub.docker.com/repository/docker/esrrhs/pingtunnel)
|
|
[<img src="https://img.shields.io/github/workflow/status/esrrhs/pingtunnel/Go">](https://github.com/esrrhs/pingtunnel/actions)
|
|
|
|
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
|
|
|
|
|
|
|
|
## 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](https://github.com/esrrhs/pingtunnel/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](https://github.com/esrrhs/pingtunnel/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
|
|
|
|
<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/GoLand.png" height="200"/></a>
|
|
|
|
|