Pingtunnel

Pingtunnel 是一款通过 ICMP 发送 TCP/UDP 流量的工具。

注意：本工具仅供学习研究使用，请勿用于非法用途

使用方法与详细文档

📖 详细文档请参阅 USAGE.md：包含完整的命令行参数、配置文件用法（-c config.json），以及各种代理场景的配置指南（全局 SOCKS5 代理、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 客户端：

• pingtunnel-client

非常感谢 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