返回更新列表
新发布Sep 12, 2026

pingtunnel master-d7cd0d6ab5f18e7d8d050385e8d240b3b2f41e6c

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

分享

Pingtunnel

codecov

Pingtunnel 是一款网络工具,可将 TCP/UDP/SOCKS5 流量封装在 ICMP Echo(Ping)数据包中进行隧道传输,从而绕过严格的网络防火墙或受限速的 TCP/UDP 流量。

⚠️ 注意:本工具严格仅供学习与研究之用。请勿将其用于任何非法目的。

image


🌟 特性

  • 统一的 v3 安全架构:旧版的数字密钥和独立的加密开关已被移除。单一的共享密码(-password)即可驱动双向认证与端到端 AEAD 加密(默认 chacha20-poly1305,可选 aes256/aes128)。
  • 多种模式:
    • SOCKS5 代理:一条命令即可启动本地 SOCKS5 代理,并可选启用用户名/密码认证;
    • TCP 端口转发:访问指定的远程 TCP 端口(例如 SSH、Web、RDP);
    • UDP 端口转发:转发游戏 UDP 流量、DNS 53 端口等;
    • 服务端二级转发(-forward):服务端可通过上游 SOCKS5/HTTP 代理中继传入流量。
  • 灵活的配置方式(推荐使用配置文件模式):
    • 直接使用配置文件运行:pingtunnel config.json 或 pingtunnel -c config.json;
    • 默认会自动加载当前目录下的 config.json;
    • 命令行参数始终会覆盖配置文件中对应的值。
  • 在弱网环境下表现稳健:内置带宽自适应拥塞控制算法(bb),可抑制缓冲区膨胀(bufferbloat)以及丢包导致的卡顿。

🚀 快速开始

方式一:配置文件模式(推荐)

仓库中附带了示例文件。只需填入你的服务器 IP 和一个强密码:

1. 服务端配置(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

2. 客户端配置(SOCKS5 代理模式,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。


选项 2:命令行(CLI)

1. 启动服务器

在具有公网 IP 的机器上运行:

sudo ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE

(可选) 禁用 Linux 内核默认的 ICMP echo 回复,以避免干扰:

echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all

2. 启动客户端

  • SOCKS5 代理模式:
    ./pingtunnel -type client -l 127.0.0.1:1080 -s YOUR_SERVER_IP -socks5 -password YOUR_STRONG_PASSWORD_HERE
    
  • TCP 端口转发(默认模式,例如将远程内网 192.168.1.100:22 映射到本地端口 2222):
    ./pingtunnel -type client -l :2222 -s YOUR_SERVER_IP -t 192.168.1.100:22 -password YOUR_STRONG_PASSWORD_HERE
    
  • UDP 转发(例如将本地端口 5353 转发到公共 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

运行服务器

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 用法与配置指南

分类