From f365e94395e62d6b178317977f2cb32387a05e42 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Wed, 30 Sep 2020 17:39:13 +0800 Subject: [PATCH 01/22] Update README_EN.md --- README_EN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_EN.md b/README_EN.md index 871c33e..73dcb6d 100644 --- a/README_EN.md +++ b/README_EN.md @@ -28,7 +28,7 @@ sudo ./pingtunnel -type server ``` * (Optional) Disable system default ping ``` -echo 1> / proc / sys / net / ipv4 / icmp_echo_ignore_all +echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all ``` ### Install GUI client (recommended by novices) * Download the gui version of qt from [pingtunnel-qt](https://github.com/esrrhs/pingtunnel-qt) From a3209179a0fd58d872fa9be618bae977827e95ca Mon Sep 17 00:00:00 2001 From: zhao xin Date: Wed, 14 Oct 2020 20:21:08 +0800 Subject: [PATCH 02/22] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6c14cbc..1c122f2 100644 --- a/README.md +++ b/README.md @@ -94,7 +94,7 @@ QT GUI: https://github.com/esrrhs/pingtunnel-qt #### 路由器使用 参考[yellowsocks](https://github.com/esrrhs/yellowsocks)的使用 #### 手机端使用 -建议套用其他协议使用，如phone client->pingtunnel client->pingtunnel server->phone server +建议套用其他协议使用，如phone client->pingtunnel client->pingtunnel server->phone server。或者使用[spp-shadowsocks-plugin-android](https://github.com/esrrhs/spp-shadowsocks-plugin-android) # Usage 通过伪造ping，把tcp/udp/sock5流量通过远程服务器转发到目的服务器上。用于突破某些运营商封锁TCP/UDP流量。 From 76deebb4b0cfb847eb8267b9ecc621746292020b Mon Sep 17 00:00:00 2001 From: zhao xin Date: Wed, 14 Oct 2020 20:21:46 +0800 Subject: [PATCH 03/22] Update README_EN.md --- README_EN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_EN.md b/README_EN.md index 73dcb6d..21591ae 100644 --- a/README_EN.md +++ b/README_EN.md @@ -89,7 +89,7 @@ QT GUI: https://github.com/esrrhs/pingtunnel-qt #### Router use refer to the use of [yellowsocks](https://github.com/esrrhs/yellowsocks) #### Mobile phone use -It is recommended to use other protocols, such as phone client-> pingtunnel client-> pingtunnel server-> phone server +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) # 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. From 1c51495b9ae6d2b3a56400f9d84adbe4ffa1b880 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Sat, 31 Oct 2020 23:03:22 +0800 Subject: [PATCH 04/22] Update README.md --- README.md | 100 +++--------------------------------------------------- 1 file changed, 4 insertions(+), 96 deletions(-) diff --git a/README.md b/README.md index 1c122f2..da80647 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ [](https://github.com/esrrhs/pingtunnel/actions) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/a200bca59d1b4ca7a9c2cdb564508b47)](https://www.codacy.com/manual/esrrhs/pingtunnel?utm_source=github.com&utm_medium=referral&utm_content=esrrhs/pingtunnel&utm_campaign=Badge_Grade) -pingtunnel是把tcp/udp/sock5流量伪装成icmp流量进行转发的工具。用于突破网络封锁，或是绕过WIFI网络的登陆验证，或是在某些网络加快网络传输速度。 +pingtunnel是把tcp/udp/sock5流量伪装成icmp流量进行转发的工具 [Readme EN](./README_EN.md) @@ -17,14 +17,9 @@ pingtunnel是把tcp/udp/sock5流量伪装成icmp流量进行转发的工具。 ![image](network.jpg) -# 功能 -* 某些服务器的tcp、udp流量被禁止，可以通过pingtunnel绕过。 -* 某些场合如学校、咖啡厅、机场，需要登录跳转验证，可以通过pingtunnel绕过。 -* 某些网络，tcp、udp传输很慢，可以通过pingtunnel加速网络。 - # 使用 ### 安装服务端 -* 首先准备好一个具有公网ip的服务器，如AWS上的EC2，假定域名或者公网ip是www.yourserver.com +* 首先准备好一个具有公网ip的服务器，假定域名或者公网ip是www.yourserver.com * 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如pingtunnel_linux64.zip，然后解压，以**root**权限执行 ``` sudo wget (最新release的下载链接) @@ -39,7 +34,7 @@ echo 1 >/proc/sys/net/ipv4/icmp_echo_ignore_all * 从[pingtunnel-qt](https://github.com/esrrhs/pingtunnel-qt)下载qt的gui版本 * 双击exe运行，修改server（如www.yourserver.com）、listen port（如1080），勾上sock5，其他设置默认即可，然后点击*GO* * 一切正常，界面上会有ping值显示，然后可点击X隐藏到状态栏 -* 设置浏览器的sock5代理到127.0.0.1:1080，如果连不上网，出现socks version not supported错误日志，说明浏览器的代理不是socks5代理。如果提示非安全连接，说明dns有问题，勾上浏览器的【使用socks5代理DNS查询】，或者参考[yellowdns](https://github.com/esrrhs/yellowdns) +* 设置浏览器的sock5代理到127.0.0.1:1080，如果连不上网，出现socks version not supported错误日志，说明浏览器的代理不是socks5代理。如果提示非安全连接，说明dns有问题，勾上浏览器的【使用socks5代理DNS查询】 ![image](qtrun.jpg) @@ -73,101 +68,14 @@ docker run --name pingtunnel-client -d --restart=always -p 1080:1080 esrrhs/ping # 效果 下载centos镜像 [centos mirror](http://mirrors.ocf.berkeley.edu/centos/8.2.2004/isos/x86_64/CentOS-8.2.2004-x86_64-dvd1.iso) -直接wget、通过shadowsocks wget、通过kcptun wget、通过pingtunnel wget的结果如下 +对比如下 | | wget | shaowsocks | kcptun | pingtunnel | |--------------|----------|------------|------------|------------| | 阿里云 | 26.6KB/s | 31.8KB/s | 606KB/s |5.64MB/s| -可以看到加速效果基本上**200倍**。 - # 下载 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) - -# 其他 -#### 路由器使用 -参考[yellowsocks](https://github.com/esrrhs/yellowsocks)的使用 -#### 手机端使用 -建议套用其他协议使用，如phone client->pingtunnel client->pingtunnel server->phone server。或者使用[spp-shadowsocks-plugin-android](https://github.com/esrrhs/spp-shadowsocks-plugin-android) - -# Usage - 通过伪造ping，把tcp/udp/sock5流量通过远程服务器转发到目的服务器上。用于突破某些运营商封锁TCP/UDP流量。 - - 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 服务器或者客户端 - - 服务器参数: - - -key 设置的密码，默认0 - - -nolog 不写日志文件，只打印标准输出，默认0 - - -noprint 不打印屏幕输出，默认0 - - -loglevel 日志文件等级，默认info - - -maxconn 最大连接数，默认0，不受限制 - - -maxprt server最大处理线程数，默认100 - - -maxprb server最大处理线程buffer数，默认1000 - - -conntt server发起连接到目标地址的超时时间，默认1000ms - - 客户端参数: - - -l 本地的地址，发到这个端口的流量将转发到服务器 - - -s 服务器的地址，流量将通过隧道转发到这个服务器 - - -t 远端服务器转发的目的地址，流量将转发到这个地址 - - -timeout 本地记录连接超时的时间，单位是秒，默认60s - - -key 设置的密码，默认0 - - -tcp 设置是否转发tcp，默认0 - - -tcp_bs tcp的发送接收缓冲区大小，默认1MB - - -tcp_mw tcp的最大窗口，默认10000 - - -tcp_rst tcp的超时发送时间，默认400ms - - -tcp_gz 当数据包超过这个大小，tcp将压缩数据，0表示不压缩，默认0 - - -tcp_stat 打印tcp的监控，默认0 - - -nolog 不写日志文件，只打印标准输出，默认0 - - -noprint 不打印屏幕输出，默认0 - - -loglevel 日志文件等级，默认info - - -sock5 开启sock5转发，默认0 - - -profile 在指定端口开启性能检测，默认0不开启 - - -s5filter sock5模式设置转发过滤，默认全转发，设置CN代表CN地区的直连不转发 - - -s5ftfile sock5模式转发过滤的数据文件，默认读取当前目录的GeoLite2-Country.mmdb - From 0d6b8361733fb439651ebaedd340742e041e46c5 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Sat, 31 Oct 2020 23:06:46 +0800 Subject: [PATCH 05/22] Update README.md --- README.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/README.md b/README.md index da80647..7264896 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,6 @@ pingtunnel是把tcp/udp/sock5流量伪装成icmp流量进行转发的工具 [Readme EN](./README_EN.md) **注意：本工具只是用作学习研究，请勿用于非法用途！** - ![image](network.jpg) # 使用 @@ -35,7 +34,6 @@ echo 1 >/proc/sys/net/ipv4/icmp_echo_ignore_all * 双击exe运行，修改server（如www.yourserver.com）、listen port（如1080），勾上sock5，其他设置默认即可，然后点击*GO* * 一切正常，界面上会有ping值显示，然后可点击X隐藏到状态栏 * 设置浏览器的sock5代理到127.0.0.1:1080，如果连不上网，出现socks version not supported错误日志，说明浏览器的代理不是socks5代理。如果提示非安全连接，说明dns有问题，勾上浏览器的【使用socks5代理DNS查询】 - ![image](qtrun.jpg) ### 安装客户端(高玩推荐) @@ -66,10 +64,7 @@ docker run --name pingtunnel-client -d --restart=always -p 1080:1080 esrrhs/ping ``` # 效果 -下载centos镜像 [centos mirror](http://mirrors.ocf.berkeley.edu/centos/8.2.2004/isos/x86_64/CentOS-8.2.2004-x86_64-dvd1.iso) - -对比如下 - +下载centos镜像 [centos mirror](http://mirrors.ocf.berkeley.edu/centos/8.2.2004/isos/x86_64/CentOS-8.2.2004-x86_64-dvd1.iso)，对比如下 | | wget | shaowsocks | kcptun | pingtunnel | |--------------|----------|------------|------------|------------| | 阿里云 | 26.6KB/s | 31.8KB/s | 606KB/s |5.64MB/s| From 395a89063289e4419d47188b1c6a5a16f94d1136 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Sat, 31 Oct 2020 23:07:13 +0800 Subject: [PATCH 06/22] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7264896..f7076e1 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ pingtunnel是把tcp/udp/sock5流量伪装成icmp流量进行转发的工具 [Readme EN](./README_EN.md) -**注意：本工具只是用作学习研究，请勿用于非法用途！** +**注意：本工具只是用作学习研究，请勿用于非法用途！！！** ![image](network.jpg) # 使用 From 6b7bc8e8769f33a406bc820f17ecb40e2f9811a8 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Sat, 31 Oct 2020 23:08:41 +0800 Subject: [PATCH 07/22] Update README_EN.md --- README_EN.md | 100 ++------------------------------------------------- 1 file changed, 2 insertions(+), 98 deletions(-) diff --git a/README_EN.md b/README_EN.md index 21591ae..e9c7fba 100644 --- a/README_EN.md +++ b/README_EN.md @@ -9,14 +9,9 @@ [](https://github.com/esrrhs/pingtunnel/actions) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/a200bca59d1b4ca7a9c2cdb564508b47)](https://www.codacy.com/manual/esrrhs/pingtunnel?utm_source=github.com&utm_medium=referral&utm_content=esrrhs/pingtunnel&utm_campaign=Badge_Grade) -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. - +Pingtunnel is a tool that advertises tcp/udp/sock5 traffic as icmp traffic for forwarding. ![image](network.jpg) -# Why use this -* 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. -* In some networks, TCP/UDP transmission is very slow. You can speed up the network through pingtunnel. # 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 @@ -34,8 +29,7 @@ echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all * 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 -* 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) - +* 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. ![image](qtrun.jpg) ### Install the client (recommended for high play) @@ -67,101 +61,11 @@ docker run --name pingtunnel-client -d --restart = always -p 1080: 1080 esrrhs / # Test 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) - -the results of direct wget, shadowsocks wget, kcptun wget, and pingtunnel wget are as follows. - | | wget | shaowsocks | kcptun | pingtunnel | |--------------|----------|------------|------------|------------| | AlibabaCloud | 26.6KB/s | 31.8KB/s | 606KB/s |5.64MB/s| -the acceleration effect is basically **200 times**. - # 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) - -# Other -#### Router use -refer to the use of [yellowsocks](https://github.com/esrrhs/yellowsocks) -#### Mobile phone use -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) - -# 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 - - 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: - - -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 From db05e85500127fed5db4e66a54d62e7d6ce335f4 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Sat, 31 Oct 2020 23:09:55 +0800 Subject: [PATCH 08/22] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index f7076e1..1d3f70a 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,7 @@ pingtunnel是把tcp/udp/sock5流量伪装成icmp流量进行转发的工具 [Readme EN](./README_EN.md) **注意：本工具只是用作学习研究，请勿用于非法用途！！！** + ![image](network.jpg) # 使用 @@ -34,6 +35,7 @@ echo 1 >/proc/sys/net/ipv4/icmp_echo_ignore_all * 双击exe运行，修改server（如www.yourserver.com）、listen port（如1080），勾上sock5，其他设置默认即可，然后点击*GO* * 一切正常，界面上会有ping值显示，然后可点击X隐藏到状态栏 * 设置浏览器的sock5代理到127.0.0.1:1080，如果连不上网，出现socks version not supported错误日志，说明浏览器的代理不是socks5代理。如果提示非安全连接，说明dns有问题，勾上浏览器的【使用socks5代理DNS查询】 + ![image](qtrun.jpg) ### 安装客户端(高玩推荐) From fd4c4ebb4753ab6d704bf256261becb58ba6dd2a Mon Sep 17 00:00:00 2001 From: zhao xin Date: Sat, 31 Oct 2020 23:10:21 +0800 Subject: [PATCH 09/22] Update README_EN.md --- README_EN.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README_EN.md b/README_EN.md index e9c7fba..fdf6f57 100644 --- a/README_EN.md +++ b/README_EN.md @@ -10,6 +10,7 @@ [![Codacy Badge](https://api.codacy.com/project/badge/Grade/a200bca59d1b4ca7a9c2cdb564508b47)](https://www.codacy.com/manual/esrrhs/pingtunnel?utm_source=github.com&utm_medium=referral&utm_content=esrrhs/pingtunnel&utm_campaign=Badge_Grade) Pingtunnel is a tool that advertises tcp/udp/sock5 traffic as icmp traffic for forwarding. + ![image](network.jpg) # Use @@ -30,6 +31,7 @@ echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all * 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 * 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. + ![image](qtrun.jpg) ### Install the client (recommended for high play) From ad696391174b6204ea4932597d0fd040416da47a Mon Sep 17 00:00:00 2001 From: zhao xin Date: Sat, 31 Oct 2020 23:11:15 +0800 Subject: [PATCH 10/22] Update README.md --- README.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/README.md b/README.md index 1d3f70a..b09e264 100644 --- a/README.md +++ b/README.md @@ -70,9 +70,3 @@ docker run --name pingtunnel-client -d --restart=always -p 1080:1080 esrrhs/ping | | wget | shaowsocks | kcptun | pingtunnel | |--------------|----------|------------|------------|------------| | 阿里云 | 26.6KB/s | 31.8KB/s | 606KB/s |5.64MB/s| - -# 下载 -cmd: https://github.com/esrrhs/pingtunnel/releases - -QT GUI: https://github.com/esrrhs/pingtunnel-qt - From 7454c250dc97d782555b61240086a6cced2c9769 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Sat, 31 Oct 2020 23:11:29 +0800 Subject: [PATCH 11/22] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b09e264..ac6effe 100644 --- a/README.md +++ b/README.md @@ -67,6 +67,6 @@ docker run --name pingtunnel-client -d --restart=always -p 1080:1080 esrrhs/ping # 效果 下载centos镜像 [centos mirror](http://mirrors.ocf.berkeley.edu/centos/8.2.2004/isos/x86_64/CentOS-8.2.2004-x86_64-dvd1.iso)，对比如下 -| | wget | shaowsocks | kcptun | pingtunnel | +| | wget | ss | kcp | pingtunnel | |--------------|----------|------------|------------|------------| | 阿里云 | 26.6KB/s | 31.8KB/s | 606KB/s |5.64MB/s| From 6fc899c759e5ac6b6941c0dd09e092f4a672ac7a Mon Sep 17 00:00:00 2001 From: zhao xin Date: Sat, 31 Oct 2020 23:12:08 +0800 Subject: [PATCH 12/22] Update README_EN.md --- README_EN.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/README_EN.md b/README_EN.md index fdf6f57..257c60f 100644 --- a/README_EN.md +++ b/README_EN.md @@ -63,11 +63,6 @@ docker run --name pingtunnel-client -d --restart = always -p 1080: 1080 esrrhs / # Test 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) -| | wget | shaowsocks | kcptun | pingtunnel | +| | wget | ss | kcp | pingtunnel | |--------------|----------|------------|------------|------------| | AlibabaCloud | 26.6KB/s | 31.8KB/s | 606KB/s |5.64MB/s| - -# Download -cmd: https://github.com/esrrhs/pingtunnel/releases - -QT GUI: https://github.com/esrrhs/pingtunnel-qt From 49d1af71b45bb6b39eacfa3a7f8160eb32e14a93 Mon Sep 17 00:00:00 2001 From: phanirithvij Date: Wed, 23 Dec 2020 07:41:06 +0530 Subject: [PATCH 13/22] fix some markdown issues in the readme To improve coverage --- README.md | 66 ++++++++++++++++++++++++++++++++++------------------ README_EN.md | 62 ++++++++++++++++++++++++++++++++---------------- 2 files changed, 85 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index ac6effe..89b6540 100644 --- a/README.md +++ b/README.md @@ -7,66 +7,86 @@ [](https://github.com/esrrhs/pingtunnel/releases) [](https://hub.docker.com/repository/docker/esrrhs/pingtunnel) [](https://github.com/esrrhs/pingtunnel/actions) -[![Codacy Badge](https://api.codacy.com/project/badge/Grade/a200bca59d1b4ca7a9c2cdb564508b47)](https://www.codacy.com/manual/esrrhs/pingtunnel?utm_source=github.com&utm_medium=referral&utm_content=esrrhs/pingtunnel&utm_campaign=Badge_Grade) +[![Codacy Badge](https://api.codacy.com/project/badge/Grade/a200bca59d1b4ca7a9c2cdb564508b47)](https://www.codacy.com/manual/esrrhs/pingtunnel?utm_source=github.com&utm_medium=referral&utm_content=esrrhs/pingtunnel&utm_campaign=Badge_Grade) -pingtunnel是把tcp/udp/sock5流量伪装成icmp流量进行转发的工具 +pingtunnel 是把 tcp/udp/sock5 流量伪装成 icmp 流量进行转发的工具 [Readme EN](./README_EN.md) -**注意：本工具只是用作学习研究，请勿用于非法用途！！！** +### 注意：本工具只是用作学习研究，请勿用于非法用途！！！ ![image](network.jpg) -# 使用 +## 使用 + ### 安装服务端 -* 首先准备好一个具有公网ip的服务器，假定域名或者公网ip是www.yourserver.com -* 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如pingtunnel_linux64.zip，然后解压，以**root**权限执行 + +- 首先准备好一个具有公网 ip 的服务器，假定域名或者公网 ip 是www.yourserver.com +- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_linux64.zip，然后解压，以**root**权限执行 + ``` sudo wget (最新release的下载链接) sudo unzip pingtunnel_linux64.zip sudo ./pingtunnel -type server ``` -* (可选)关闭系统默认的ping + +- (可选)关闭系统默认的 ping + ``` echo 1 >/proc/sys/net/ipv4/icmp_echo_ignore_all ``` -### 安装GUI客户端(新手推荐) -* 从[pingtunnel-qt](https://github.com/esrrhs/pingtunnel-qt)下载qt的gui版本 -* 双击exe运行，修改server（如www.yourserver.com）、listen port（如1080），勾上sock5，其他设置默认即可，然后点击*GO* -* 一切正常，界面上会有ping值显示，然后可点击X隐藏到状态栏 -* 设置浏览器的sock5代理到127.0.0.1:1080，如果连不上网，出现socks version not supported错误日志，说明浏览器的代理不是socks5代理。如果提示非安全连接，说明dns有问题，勾上浏览器的【使用socks5代理DNS查询】 + +### 安装 GUI 客户端(新手推荐) + +- 从[pingtunnel-qt](https://github.com/esrrhs/pingtunnel-qt)下载 qt 的 gui 版本 +- 双击 exe 运行，修改 server（如www.yourserver.com）、listen port（如 1080），勾上 sock5，其他设置默认即可，然后点击*GO* +- 一切正常，界面上会有 ping 值显示，然后可点击 X 隐藏到状态栏 +- 设置浏览器的 sock5 代理到 127.0.0.1:1080，如果连不上网，出现 socks version not supported 错误日志，说明浏览器的代理不是 socks5 代理。如果提示非安全连接，说明 dns 有问题，勾上浏览器的【使用 socks5 代理 DNS 查询】 ![image](qtrun.jpg) ### 安装客户端(高玩推荐) -* 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如pingtunnel_windows64.zip，解压 -* 然后用**管理员权限**运行，不同的转发功能所对应的命令如下 -* 如果看到有ping pong的log，说明连接正常 -##### 转发sock5 + +- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_windows64.zip，解压 +- 然后用**管理员权限**运行，不同的转发功能所对应的命令如下 +- 如果看到有 ping pong 的 log，说明连接正常 + +#### 转发 sock5 + ``` pingtunnel.exe -type client -l :4455 -s www.yourserver.com -sock5 1 ``` -##### 转发tcp + +#### 转发 tcp + ``` pingtunnel.exe -type client -l :4455 -s www.yourserver.com -t www.yourserver.com:4455 -tcp 1 ``` -##### 转发udp + +#### 转发 udp + ``` pingtunnel.exe -type client -l :4455 -s www.yourserver.com -t www.yourserver.com:4455 ``` ### Docker + 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 ``` -# 效果 -下载centos镜像 [centos mirror](http://mirrors.ocf.berkeley.edu/centos/8.2.2004/isos/x86_64/CentOS-8.2.2004-x86_64-dvd1.iso)，对比如下 -| | wget | ss | kcp | pingtunnel | -|--------------|----------|------------|------------|------------| -| 阿里云 | 26.6KB/s | 31.8KB/s | 606KB/s |5.64MB/s| +## 效果 + +下载 centos 镜像 [centos mirror](http://mirrors.ocf.berkeley.edu/centos/8.2.2004/isos/x86_64/CentOS-8.2.2004-x86_64-dvd1.iso)，对比如下 + +| | wget | ss | kcp | pingtunnel | +| ------ | -------- | -------- | ------- | ---------- | +| 阿里云 | 26.6KB/s | 31.8KB/s | 606KB/s | 5.64MB/s | diff --git a/README_EN.md b/README_EN.md index 257c60f..f68cdf7 100644 --- a/README_EN.md +++ b/README_EN.md @@ -7,62 +7,84 @@ [](https://github.com/esrrhs/pingtunnel/releases) [](https://hub.docker.com/repository/docker/esrrhs/pingtunnel) [](https://github.com/esrrhs/pingtunnel/actions) -[![Codacy Badge](https://api.codacy.com/project/badge/Grade/a200bca59d1b4ca7a9c2cdb564508b47)](https://www.codacy.com/manual/esrrhs/pingtunnel?utm_source=github.com&utm_medium=referral&utm_content=esrrhs/pingtunnel&utm_campaign=Badge_Grade) +[![Codacy Badge](https://api.codacy.com/project/badge/Grade/a200bca59d1b4ca7a9c2cdb564508b47)](https://www.codacy.com/manual/esrrhs/pingtunnel?utm_source=github.com&utm_medium=referral&utm_content=esrrhs/pingtunnel&utm_campaign=Badge_Grade) Pingtunnel is a tool that advertises tcp/udp/sock5 traffic as icmp traffic for forwarding. +> Note: This tool is only to be used for study and research, do not use it for illegal purposes. + ![image](network.jpg) -# Use +## 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 + +- 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 + +- (Optional) Disable system default ping + ``` echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all ``` + ### 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 -* 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. + +- 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 +- 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. ![image](qtrun.jpg) ### Install the client (recommended for high play) -* 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 + +- 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 + +#### Forward tcp + ``` pingtunnel.exe -type client -l: 4455 -s www.yourserver.com -t www.yourserver.com:4455 -tcp 1 ``` -##### Forward udp + +#### Forward udp + ``` pingtunnel.exe -type client -l: 4455 -s www.yourserver.com -t www.yourserver.com:4455 ``` ### Use Docker + 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 ``` -# Test -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) -| | wget | ss | kcp | pingtunnel | -|--------------|----------|------------|------------|------------| -| AlibabaCloud | 26.6KB/s | 31.8KB/s | 606KB/s |5.64MB/s| +## Test + +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) + +| | wget | ss | kcp | pingtunnel | +| ------------ | -------- | -------- | ------- | ---------- | +| AlibabaCloud | 26.6KB/s | 31.8KB/s | 606KB/s | 5.64MB/s | From 8db60694b69ac56272f913af837c813ef1521715 Mon Sep 17 00:00:00 2001 From: phanirithvij Date: Wed, 23 Dec 2020 08:08:49 +0530 Subject: [PATCH 14/22] fix new issues --- README.md | 22 +++++++++++----------- README_EN.md | 22 +++++++++++----------- 2 files changed, 22 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 89b6540..e812a7d 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ pingtunnel 是把 tcp/udp/sock5 流量伪装成 icmp 流量进行转发的工具 [Readme EN](./README_EN.md) -### 注意：本工具只是用作学习研究，请勿用于非法用途！！！ +## 注意：本工具只是用作学习研究，请勿用于非法用途！！！ ![image](network.jpg) @@ -21,8 +21,8 @@ pingtunnel 是把 tcp/udp/sock5 流量伪装成 icmp 流量进行转发的工具 ### 安装服务端 -- 首先准备好一个具有公网 ip 的服务器，假定域名或者公网 ip 是www.yourserver.com -- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_linux64.zip，然后解压，以**root**权限执行 +- 首先准备好一个具有公网 ip 的服务器，假定域名或者公网 ip 是www.yourserver.com +- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_linux64.zip，然后解压，以**root**权限执行 ``` sudo wget (最新release的下载链接) @@ -30,7 +30,7 @@ sudo unzip pingtunnel_linux64.zip sudo ./pingtunnel -type server ``` -- (可选)关闭系统默认的 ping +- (可选)关闭系统默认的 ping ``` echo 1 >/proc/sys/net/ipv4/icmp_echo_ignore_all @@ -38,18 +38,18 @@ echo 1 >/proc/sys/net/ipv4/icmp_echo_ignore_all ### 安装 GUI 客户端(新手推荐) -- 从[pingtunnel-qt](https://github.com/esrrhs/pingtunnel-qt)下载 qt 的 gui 版本 -- 双击 exe 运行，修改 server（如www.yourserver.com）、listen port（如 1080），勾上 sock5，其他设置默认即可，然后点击*GO* -- 一切正常，界面上会有 ping 值显示，然后可点击 X 隐藏到状态栏 -- 设置浏览器的 sock5 代理到 127.0.0.1:1080，如果连不上网，出现 socks version not supported 错误日志，说明浏览器的代理不是 socks5 代理。如果提示非安全连接，说明 dns 有问题，勾上浏览器的【使用 socks5 代理 DNS 查询】 +- 从[pingtunnel-qt](https://github.com/esrrhs/pingtunnel-qt)下载 qt 的 gui 版本 +- 双击 exe 运行，修改 server（如www.yourserver.com）、listen port（如 1080），勾上 sock5，其他设置默认即可，然后点击*GO* +- 一切正常，界面上会有 ping 值显示，然后可点击 X 隐藏到状态栏 +- 设置浏览器的 sock5 代理到 127.0.0.1:1080，如果连不上网，出现 socks version not supported 错误日志，说明浏览器的代理不是 socks5 代理。如果提示非安全连接，说明 dns 有问题，勾上浏览器的【使用 socks5 代理 DNS 查询】 ![image](qtrun.jpg) ### 安装客户端(高玩推荐) -- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_windows64.zip，解压 -- 然后用**管理员权限**运行，不同的转发功能所对应的命令如下 -- 如果看到有 ping pong 的 log，说明连接正常 +- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_windows64.zip，解压 +- 然后用**管理员权限**运行，不同的转发功能所对应的命令如下 +- 如果看到有 ping pong 的 log，说明连接正常 #### 转发 sock5 diff --git a/README_EN.md b/README_EN.md index f68cdf7..392339d 100644 --- a/README_EN.md +++ b/README_EN.md @@ -11,7 +11,7 @@ Pingtunnel is a tool that advertises tcp/udp/sock5 traffic as icmp traffic for forwarding. -> Note: This tool is only to be used for study and research, do not use it for illegal purposes. +## Note: This tool is only to be used for study and research, do not use it for illegal purposes. ![image](network.jpg) @@ -19,8 +19,8 @@ Pingtunnel is a tool that advertises tcp/udp/sock5 traffic as icmp traffic for f ### 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 +- 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) @@ -28,7 +28,7 @@ sudo unzip pingtunnel_linux64.zip sudo ./pingtunnel -type server ``` -- (Optional) Disable system default ping +- (Optional) Disable system default ping ``` echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all @@ -36,18 +36,18 @@ echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all ### 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 -- 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. +- 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 +- 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. ![image](qtrun.jpg) ### Install the client (recommended for high play) -- 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 +- 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 From 7f8d5fa39026d5fea36062ab6e43349c5cd7de0c Mon Sep 17 00:00:00 2001 From: phanirithvij Date: Wed, 23 Dec 2020 08:14:27 +0530 Subject: [PATCH 15/22] fix more --- README.md | 20 ++++++++++---------- README_EN.md | 22 +++++++++++----------- 2 files changed, 21 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index e812a7d..4807612 100644 --- a/README.md +++ b/README.md @@ -21,8 +21,8 @@ pingtunnel 是把 tcp/udp/sock5 流量伪装成 icmp 流量进行转发的工具 ### 安装服务端 -- 首先准备好一个具有公网 ip 的服务器，假定域名或者公网 ip 是www.yourserver.com -- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_linux64.zip，然后解压，以**root**权限执行 +- 首先准备好一个具有公网 ip 的服务器，假定域名或者公网 ip 是www.yourserver.com +- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_linux64.zip，然后解压，以**root**权限执行 ``` sudo wget (最新release的下载链接) @@ -30,7 +30,7 @@ sudo unzip pingtunnel_linux64.zip sudo ./pingtunnel -type server ``` -- (可选)关闭系统默认的 ping +- (可选)关闭系统默认的 ping ``` echo 1 >/proc/sys/net/ipv4/icmp_echo_ignore_all @@ -38,18 +38,18 @@ echo 1 >/proc/sys/net/ipv4/icmp_echo_ignore_all ### 安装 GUI 客户端(新手推荐) -- 从[pingtunnel-qt](https://github.com/esrrhs/pingtunnel-qt)下载 qt 的 gui 版本 -- 双击 exe 运行，修改 server（如www.yourserver.com）、listen port（如 1080），勾上 sock5，其他设置默认即可，然后点击*GO* -- 一切正常，界面上会有 ping 值显示，然后可点击 X 隐藏到状态栏 -- 设置浏览器的 sock5 代理到 127.0.0.1:1080，如果连不上网，出现 socks version not supported 错误日志，说明浏览器的代理不是 socks5 代理。如果提示非安全连接，说明 dns 有问题，勾上浏览器的【使用 socks5 代理 DNS 查询】 +- 从[pingtunnel-qt](https://github.com/esrrhs/pingtunnel-qt)下载 qt 的 gui 版本 +- 双击 exe 运行，修改 server（如www.yourserver.com）、listen port（如 1080），勾上 sock5，其他设置默认即可，然后点击*GO* +- 一切正常，界面上会有 ping 值显示，然后可点击 X 隐藏到状态栏 +- 设置浏览器的 sock5 代理到 127.0.0.1:1080，如果连不上网，出现 socks version not supported 错误日志，说明浏览器的代理不是 socks5 代理。如果提示非安全连接，说明 dns 有问题，勾上浏览器的【使用 socks5 代理 DNS 查询】 ![image](qtrun.jpg) ### 安装客户端(高玩推荐) -- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_windows64.zip，解压 -- 然后用**管理员权限**运行，不同的转发功能所对应的命令如下 -- 如果看到有 ping pong 的 log，说明连接正常 +- 从[releases](https://github.com/esrrhs/pingtunnel/releases)下载对应的安装包，如 pingtunnel_windows64.zip，解压 +- 然后用**管理员权限**运行，不同的转发功能所对应的命令如下 +- 如果看到有 ping pong 的 log，说明连接正常 #### 转发 sock5 diff --git a/README_EN.md b/README_EN.md index 392339d..9445524 100644 --- a/README_EN.md +++ b/README_EN.md @@ -11,7 +11,7 @@ Pingtunnel is a tool that advertises tcp/udp/sock5 traffic as icmp traffic for forwarding. -## Note: This tool is only to be used for study and research, do not use it for illegal purposes. +## Note: This tool is only to be used for study and research, do not use it for illegal purposes ![image](network.jpg) @@ -19,8 +19,8 @@ Pingtunnel is a tool that advertises tcp/udp/sock5 traffic as icmp traffic for f ### 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 +- 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) @@ -28,7 +28,7 @@ sudo unzip pingtunnel_linux64.zip sudo ./pingtunnel -type server ``` -- (Optional) Disable system default ping +- (Optional) Disable system default ping ``` echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all @@ -36,18 +36,18 @@ echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all ### 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 -- 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. +- 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 +- 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. ![image](qtrun.jpg) ### Install the client (recommended for high play) -- 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 +- 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 From 847d475cc26847698ade71bb519e592bbdebe5c7 Mon Sep 17 00:00:00 2001 From: sajad sadrayieh Date: Tue, 23 Feb 2021 16:30:21 +0330 Subject: [PATCH 16/22] [ADD] server compose file --- docker-compose/server.yml | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 docker-compose/server.yml diff --git a/docker-compose/server.yml b/docker-compose/server.yml new file mode 100644 index 0000000..47756df --- /dev/null +++ b/docker-compose/server.yml @@ -0,0 +1,8 @@ +version: "3.7" + +services: + pingtunnelServer: + image: esrrhs/pingtunnel:latest + restart: always + network_mode: host + command: "./pingtunnel -type server -key 123456" \ No newline at end of file From bbee9243e8302c2a7026e5d51d35109bb1f5f362 Mon Sep 17 00:00:00 2001 From: sajad sadrayieh Date: Tue, 23 Feb 2021 16:33:36 +0330 Subject: [PATCH 17/22] [ADD] client compose file --- docker-compose/client.yml | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 docker-compose/client.yml diff --git a/docker-compose/client.yml b/docker-compose/client.yml new file mode 100644 index 0000000..1f27dfb --- /dev/null +++ b/docker-compose/client.yml @@ -0,0 +1,9 @@ +version: "3.7" + +services: + pingtunnelServer: + image: esrrhs/pingtunnel:latest + restart: always + ports: + - 1080:1080 + command: "./pingtunnel -type client -l 0.0.0.0:1080 -s www.yourserver.com -sock5 1 -key 123456" \ No newline at end of file From 122143529e4498d2572264cba2acfd216fb62641 Mon Sep 17 00:00:00 2001 From: sajad sadrayieh Date: Tue, 23 Feb 2021 16:39:19 +0330 Subject: [PATCH 18/22] make configs reads from env file --- docker-compose/.env | 2 ++ docker-compose/client.yml | 2 +- docker-compose/server.yml | 2 +- 3 files changed, 4 insertions(+), 2 deletions(-) create mode 100644 docker-compose/.env diff --git a/docker-compose/.env b/docker-compose/.env new file mode 100644 index 0000000..87ccc82 --- /dev/null +++ b/docker-compose/.env @@ -0,0 +1,2 @@ +KEY=123456 +SERVER=www.yourserver.com \ No newline at end of file diff --git a/docker-compose/client.yml b/docker-compose/client.yml index 1f27dfb..4eced79 100644 --- a/docker-compose/client.yml +++ b/docker-compose/client.yml @@ -6,4 +6,4 @@ services: restart: always ports: - 1080:1080 - command: "./pingtunnel -type client -l 0.0.0.0:1080 -s www.yourserver.com -sock5 1 -key 123456" \ No newline at end of file + command: "./pingtunnel -type client -l 0.0.0.0:1080 -s ${SERVER} -sock5 1 -key ${KEY}" \ No newline at end of file diff --git a/docker-compose/server.yml b/docker-compose/server.yml index 47756df..63e6009 100644 --- a/docker-compose/server.yml +++ b/docker-compose/server.yml @@ -5,4 +5,4 @@ services: image: esrrhs/pingtunnel:latest restart: always network_mode: host - command: "./pingtunnel -type server -key 123456" \ No newline at end of file + command: "./pingtunnel -type server -key ${KEY}" \ No newline at end of file From 24fa2404dd7f0ba74ff415fc8fe3bf0648432d76 Mon Sep 17 00:00:00 2001 From: sajad sadrayieh Date: Tue, 23 Feb 2021 16:46:12 +0330 Subject: [PATCH 19/22] a basic documentation for easy deploy --- docker-compose/Readme.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 docker-compose/Readme.md diff --git a/docker-compose/Readme.md b/docker-compose/Readme.md new file mode 100644 index 0000000..834b79e --- /dev/null +++ b/docker-compose/Readme.md @@ -0,0 +1,16 @@ +Deploy with docker-compose +=========================== + **First** edit `.env` file in this directory to your appropriate value. + +**Then** run stack with these commands: + +- in the server +``` +docker-compose -f server.yml up -d +``` +- in client machine +``` +docker-compose -f client.yml up -d +``` + +**Now** use socks5 proxy at port `1080` of your client machine \ No newline at end of file From 41ccdf6d7fefac4cc067bd07e3f1f324e451cc78 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Thu, 18 Mar 2021 11:22:13 +0800 Subject: [PATCH 20/22] Update Dockerfile --- Dockerfile | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Dockerfile b/Dockerfile index 90439eb..aa799de 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,8 +1,8 @@ FROM golang AS build-env -RUN go get -u github.com/esrrhs/pingtunnel -RUN go get -u github.com/esrrhs/pingtunnel/... -RUN go install github.com/esrrhs/pingtunnel +RUN GO111MODULE=off go get -u github.com/esrrhs/pingtunnel +RUN GO111MODULE=off go get -u github.com/esrrhs/pingtunnel/... +RUN GO111MODULE=off go install github.com/esrrhs/pingtunnel FROM debian COPY --from=build-env /go/bin/pingtunnel . From cd21d586aef4cfac7ab76269f1605713d3c25212 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Thu, 1 Apr 2021 11:49:07 +0800 Subject: [PATCH 21/22] Update README.md --- README.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 4807612..f075389 100644 --- a/README.md +++ b/README.md @@ -69,16 +69,13 @@ pingtunnel.exe -type client -l :4455 -s www.yourserver.com -t www.yourserver.com pingtunnel.exe -type client -l :4455 -s www.yourserver.com -t www.yourserver.com:4455 ``` -### Docker - -server: - +### Docker(高玩推荐) +也可直接用docker启动，更方便。参数同上 +- server: ``` docker run --name pingtunnel-server -d --privileged --network host --restart=always esrrhs/pingtunnel ./pingtunnel -type server -key 123456 ``` - -client: - +- 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 ``` From e746dc36163703204b40ad7e457731e70f4edaf1 Mon Sep 17 00:00:00 2001 From: zhao xin Date: Thu, 1 Apr 2021 11:50:28 +0800 Subject: [PATCH 22/22] Update README_EN.md --- README_EN.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/README_EN.md b/README_EN.md index 9445524..9516a54 100644 --- a/README_EN.md +++ b/README_EN.md @@ -67,16 +67,13 @@ pingtunnel.exe -type client -l: 4455 -s www.yourserver.com -t www.yourserver.com pingtunnel.exe -type client -l: 4455 -s www.yourserver.com -t www.yourserver.com:4455 ``` -### Use Docker - -server: - +### Use Docker (recommended for high play) +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: - +- 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 ```