Pingtunnel 是一款网络工具,可将 TCP/UDP/SOCKS5 流量封装在 ICMP Echo(Ping)数据包中进行隧道传输,从而绕过严格的网络防火墙或受限速的 TCP/UDP 流量。
⚠️ 注意:本工具严格仅供学习与研究之用。请勿将其用于任何非法目的。

-password)即可驱动双向认证与端到端 AEAD 加密(默认 chacha20-poly1305,可选 aes256/aes128)。-forward):服务端可通过上游 SOCKS5/HTTP 代理中继传入流量。pingtunnel config.json 或 pingtunnel -c config.json;config.json;bb),可抑制缓冲区膨胀(bufferbloat)以及丢包导致的卡顿。仓库中附带了示例文件。只需填入你的服务器 IP 和一个强密码:
config-server.json){
"type": "server",
"password": "YOUR_STRONG_PASSWORD_HERE",
"encrypt": "chacha20",
"icmp_listen": "0.0.0.0"
}
启动服务器(需要 root / 管理员权限):
sudo ./pingtunnel config-server.json
# or: sudo ./pingtunnel -c config-server.json
config-client-socks5.json){
"type": "client",
"listen": "127.0.0.1:1080",
"server": "YOUR_SERVER_IP",
"socks5": true,
"password": "YOUR_STRONG_PASSWORD_HERE",
"encrypt": "chacha20"
}
启动客户端:
./pingtunnel config-client-socks5.json
# or: ./pingtunnel -c config-client-socks5.json
然后将浏览器或系统代理设置为 SOCKS5 127.0.0.1:1080。
在具有公网 IP 的机器上运行:
sudo ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE
(可选) 禁用 Linux 内核默认的 ICMP echo 回复,以避免干扰:
echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all
./pingtunnel -type client -l 127.0.0.1:1080 -s YOUR_SERVER_IP -socks5 -password YOUR_STRONG_PASSWORD_HERE
./pingtunnel -type client -l :2222 -s YOUR_SERVER_IP -t 192.168.1.100:22 -password YOUR_STRONG_PASSWORD_HERE
./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
有关更高级的选项和拓扑结构(服务端二级代理、端口转发、SOCKS5 认证、流量控制与拥塞调优),请参阅: 👉 USAGE.md - Pingtunnel 用法与配置指南