pingtunnel/README_EN.md

168 lines
7.8 KiB
Markdown
Raw Normal View History

2020-01-04 15:01:26 +03:00
# 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)
2020-01-06 05:42:53 +03:00
[![Go Report Card](https://goreportcard.com/badge/github.com/esrrhs/pingtunnel)](https://goreportcard.com/report/github.com/esrrhs/pingtunnel)
2020-01-04 15:01:26 +03:00
[<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)
2020-01-08 06:22:51 +03:00
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/a200bca59d1b4ca7a9c2cdb564508b47)](https://www.codacy.com/manual/esrrhs/pingtunnel?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=esrrhs/pingtunnel&amp;utm_campaign=Badge_Grade)
2020-01-04 15:01:26 +03:00
Pingtunnel is a tool that advertises tcp/udp/sock5 traffic as icmp traffic for forwarding. Used to break through the network blockade, or to bypass the WIFI network login verification, or speed up network transmission speed on some networks.
![image](network.jpg)
# Why use this
2020-01-07 17:10:28 +03:00
* TCP and UDP traffic of some servers are banned and can be bypassed by pingtunnel.
* In some occasions, such as schools, cafes, and airports, login jump authentication is required, which can be bypassed by pingtunnel.
2020-05-07 13:16:51 +03:00
* In some networks, TCP/UDP transmission is very slow. You can speed up the network through pingtunnel.
2020-01-07 17:10:28 +03:00
# Use
### 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
2020-01-08 05:49:48 +03:00
* 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
2020-01-04 15:01:26 +03:00
```
2020-01-08 05:42:49 +03:00
sudo wget (link of latest release)
2020-01-07 17:10:28 +03:00
sudo unzip pingtunnel_linux64.zip
2020-01-04 15:01:26 +03:00
sudo ./pingtunnel -type server
```
2020-01-08 05:38:33 +03:00
* (Optional) Disable system default ping
```
2020-09-30 12:39:13 +03:00
echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all
2020-01-08 05:38:33 +03:00
```
2020-01-07 17:10:28 +03:00
### Install GUI client (recommended by novices)
* Download the gui version of qt from [pingtunnel-qt](https://github.com/esrrhs/pingtunnel-qt)
* Double-click the exe to run, modify the server (such as www.yourserver.com), listen port (such as 1080), tick sock5, other settings can be default, and then click *GO*
* Everything is normal, there will be a ping value on the interface, and then you can click X to hide it in the status bar
2020-04-23 05:37:34 +03:00
* Set the browser's sock5 proxy to 127.0.0.1:1080, If you do not connect to the Internet, a socks version not supported error log appears, indicating that the browser's proxy is not a socks5 proxy.If it prompts a non-secure connection, it means there is a problem with dns. Check "Use socks5 proxy DNS query" on the browser, or refer to [yellowdns](https://github.com/esrrhs/yellowdns)
2020-01-07 17:10:28 +03:00
![image](qtrun.jpg)
2020-01-08 05:35:57 +03:00
### Install the client (recommended for high play)
2020-01-07 17:10:28 +03:00
* Download the corresponding installation package from [releases](https://github.com/esrrhs/pingtunnel/releases), such as pingtunnel_windows64.zip, and decompress it
2020-01-08 05:49:48 +03:00
* Then run with **administrator** privileges. The commands corresponding to different forwarding functions are as follows.
2020-01-08 05:33:02 +03:00
* If you see a log of ping pong, the connection is normal
2020-01-07 17:10:28 +03:00
##### Forward sock5
2020-01-04 15:01:26 +03:00
```
2020-01-07 17:10:28 +03:00
pingtunnel.exe -type client -l: 4455 -s www.yourserver.com -sock5 1
2020-01-04 15:01:26 +03:00
```
2020-01-07 17:10:28 +03:00
##### Forward tcp
2020-01-04 15:01:26 +03:00
```
2020-01-07 17:10:28 +03:00
pingtunnel.exe -type client -l: 4455 -s www.yourserver.com -t www.yourserver.com:4455 -tcp 1
2020-01-04 15:01:26 +03:00
```
2020-01-07 17:10:28 +03:00
##### Forward udp
2020-01-04 15:01:26 +03:00
```
2020-01-07 17:10:28 +03:00
pingtunnel.exe -type client -l: 4455 -s www.yourserver.com -t www.yourserver.com:4455
2020-01-04 15:01:26 +03:00
```
2020-01-07 17:10:28 +03:00
2020-01-08 05:35:57 +03:00
### Use Docker
2020-01-07 17:10:28 +03:00
server:
2020-01-04 15:01:26 +03:00
```
2020-01-07 17:10:28 +03:00
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
2020-01-04 15:01:26 +03:00
```
# Test
2020-06-27 11:22:06 +03:00
download the centos image [centos mirror](http://mirrors.ocf.berkeley.edu/centos/8.2.2004/isos/x86_64/CentOS-8.2.2004-x86_64-dvd1.iso)
2020-01-04 15:01:26 +03:00
2020-05-20 10:13:01 +03:00
the results of direct wget, shadowsocks wget, kcptun wget, and pingtunnel wget are as follows.
2020-01-04 15:01:26 +03:00
2020-05-07 13:14:40 +03:00
| | wget | shaowsocks | kcptun | pingtunnel |
|--------------|----------|------------|------------|------------|
| AlibabaCloud | 26.6KB/s | 31.8KB/s | 606KB/s |5.64MB/s|
2020-01-04 15:01:26 +03:00
2020-05-07 13:14:40 +03:00
the acceleration effect is basically **200 times**.
2020-01-04 15:01:26 +03:00
# Download
cmd: https://github.com/esrrhs/pingtunnel/releases
QT GUI: https://github.com/esrrhs/pingtunnel-qt
# Stargazers over time
[![Stargazers over time](https://starchart.cc/esrrhs/pingtunnel.svg)](https://starchart.cc/esrrhs/pingtunnel)
2020-02-28 11:12:18 +03:00
2020-02-28 11:13:52 +03:00
# Other
2020-05-25 06:21:15 +03:00
#### Router use
refer to the use of [yellowsocks](https://github.com/esrrhs/yellowsocks)
#### Mobile phone use
2020-10-14 15:21:46 +03:00
It is recommended to use other protocols, such as phone client-> pingtunnel client-> pingtunnel server-> phone server. or use [spp-shadowsocks-plugin-android](https://github.com/esrrhs/spp-shadowsocks-plugin-android)
2020-02-28 11:12:18 +03:00
2020-01-04 15:01:26 +03:00
# Usage
By forging ping, the tcp/udp/sock5 traffic is forwarded to the destination server through the remote server. Used to break certain operators to block TCP/UDP traffic.
Usage:
// server
pingtunnel -type server
// client, Forward udp
pingtunnel -type client -l LOCAL_IP:4455 -s SERVER_IP -t SERVER_IP:4455
// client, Forward tcp
pingtunnel -type client -l LOCAL_IP:4455 -s SERVER_IP -t SERVER_IP:4455 -tcp 1
// client, Forward sock5, implicitly open tcp, so no target server is needed
pingtunnel -type client -l LOCAL_IP:4455 -s SERVER_IP -sock5 1
-type client or server
2020-02-23 11:47:41 +03:00
server param:
-key Set password, default 0
-nolog Do not write log files, only print standard output, default 0 is off
-noprint Do not print standard output, default 0 is off
-loglevel log level, default is info
-maxconn the max num of connections, default 0 is no limit
-maxprt max process thread in server, default 100
-maxprb max process thread's buffer in server, default 1000
-conntt The timeout period for the server to initiate a connection to the destination address. The default is 1000ms.
client param:
2020-01-04 15:01:26 +03:00
-l Local address, traffic sent to this port will be forwarded to the server
-s The address of the server, the traffic will be forwarded to this server through the tunnel
-t Destination address forwarded by the remote server, traffic will be forwarded to this address
-timeout The time when the local record connection timed out, in seconds, 60 seconds by default
-key Set password, default 0
-tcp Set the switch to forward tcp, the default is 0
-tcp_bs Tcp send and receive buffer size, default 1MB
-tcp_mw The maximum window of tcp, the default is 10000
-tcp_rst Tcp timeout resend time, default 400ms
-tcp_gz Tcp will compress data when the packet exceeds this size, 0 means no compression, default 0
-tcp_stat Print tcp connection statistic, default 0 is off
-nolog Do not write log files, only print standard output, default 0 is off
-noprint Do not print standard output, default 0 is off
-loglevel log level, default is info
-sock5 Turn on sock5 forwarding, default 0 is off
-profile Enable performance detection on the specified port. The default 0 is not enabled.
-s5filter Set the forwarding filter in the sock5 mode. The default is full forwarding. For example, setting the CN indicates that the Chinese address is not forwarded.
-s5ftfile The data file in sock5 filter mode, the default reading of the current directory GeoLite2-Country.mmdb