← 返回列表

pingtunnel: ICMP流量伪装转发工具

聚合站 SecWiki技术 入库 2026-11-18T18:55:00

Pingtunnel is a network tool that tunnels TCP/UDP/SOCKS5 traffic over ICMP Echo (Ping) packets to bypass strict network firewalls or throttled TCP/UDP traffic.

⚠️ Note: This tool is strictly intended for study and research purposes. Do not use it for any illegal purpose.

image

Sample files ship with the repository. Just fill in your server IP and a strong password:

{
  "type": "server",
  "password": "YOUR_STRONG_PASSWORD_HERE",
  "encrypt": "chacha20",
  "icmp_listen": "0.0.0.0"
}

Start the server (requires root / administrator privileges):

sudo ./pingtunnel config-server.json
# or: sudo ./pingtunnel -c config-server.json
{
  "type": "client",
  "listen": "127.0.0.1:1080",
  "server": "YOUR_SERVER_IP",
  "socks5": true,
  "password": "YOUR_STRONG_PASSWORD_HERE",
  "encrypt": "chacha20"
}

Start the client:

./pingtunnel config-client-socks5.json
# or: ./pingtunnel -c config-client-socks5.json

Then set your browser or system proxy to SOCKS5 127.0.0.1:1080.

Run on a machine with a public IP:

sudo ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE
(Optional) Disable the Linux kernel's default ICMP echo replies to avoid interference:

echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all
- SOCKS5 proxy mode: ./pingtunnel -type client -l 127.0.0.1:1080 -s YOUR_SERVER_IP -socks5 -password YOUR_STRONG_PASSWORD_HERE
- TCP port forwarding (default mode, e.g. map remote internal 192.168.1.100:22 to local port 2222): ./pingtunnel -type client -l :2222 -s YOUR_SERVER_IP -t 192.168.1.100:22 -password YOUR_STRONG_PASSWORD_HERE
- UDP forwarding (e.g. local port 5353 to public DNS 8.8.8.8:53): ./pingtunnel -type client -l :5353 -s YOUR_SERVER_IP -t 8.8.8.8:53 -udp -password YOUR_STRONG_PASSWORD_HERE

docker run --name pingtunnel-server -d \
  --restart=always \
  --privileged \
  --network host \
  esrrhs/pingtunnel ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE
docker run --name pingtunnel-server -d \
  --restart=always \
  --privileged \
  --network host \
  -v /etc/pingtunnel/server.json:/app/server.json:ro \
  esrrhs/pingtunnel ./pingtunnel /app/server.json

For more advanced options and topologies (server-side secondary proxy, port forwarding, SOCKS5 authentication, flow control and congestion tuning), see:
👉 USAGE.md - Pingtunnel Usage and Configuration Guide

原文链接:https://github.com/esrrhs/pingtunnel