新发布Sep 12, 2026
pingtunnel master-d7cd0d6ab5f18e7d8d050385e8d240b3b2f41e6c
Pingtunnel 是一个通过 ICMP 发送 TCP/UDP 流量的工具。
Pingtunnel
Pingtunnel 是一款通过 ICMP 发送 TCP/UDP 流量的工具。
注意：本工具仅供学习研究使用，请勿用于非法用途
使用与详细文档
📖 完整使用文档请参阅 USAGE.md：包含全部命令行参数列表、配置文件模式（
-c config.json）、各场景代理设置（SOCKS5全局、GeoIP分流、TCP端口穿透、UDP转发、二级上游代理、端到端AES/ChaCha20加密）等。
快速开始
1. 服务端
- 准备一台具有公网 IP 的服务器（例如
www.yourserver.com） - 从 releases 下载发布包（例如
pingtunnel_linux64.zip），解压后以 root 权限执行：
sudo ./pingtunnel -type server -key 123456
- （可选）禁用系统默认的 ICMP echo 响应：
echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all
2. 客户端
以 管理员 权限运行：
- SOCKS5 代理模式：
pingtunnel -type client -l :4455 -s www.yourserver.com -sock5 1 -key 123456
- 转发 TCP（例如 SSH/Web）：
pingtunnel -type client -l :4455 -s www.yourserver.com -t 192.168.1.100:22 -tcp 1 -key 123456
- 转发 UDP（例如 DNS）：
pingtunnel -type client -l :4455 -s www.yourserver.com -t 8.8.8.8:53 -key 123456
3. 配置文件模式（-c）
客户端和服务端均支持 JSON 配置文件：
# Start server with config
sudo ./pingtunnel -c server.json
# Start client with config
./pingtunnel -c client.json
JSON 配置模板与规则请参阅 USAGE.md。
使用 Android 客户端
社区开发了一款专用于 pingtunnel 的 Android 客户端：
非常感谢 itismoej 开发了这款 Android 客户端！
使用 Docker
你也可以直接使用 Docker 启动 pingtunnel：
- 服务端：
docker run --name pingtunnel-server -d --privileged --network host --restart=always esrrhs/pingtunnel ./pingtunnel -type server -key 123456
- 客户端：
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