
pingtunnel master-d7cd0d6ab5f18e7d8d050385e8d240b3b2f41e6c
Pingtunnel es una herramienta que envía tráfico TCP/UDP a través de ICMP
Pingtunnel
Pingtunnel es una herramienta de red que encapsula tráfico TCP/UDP/SOCKS5 sobre paquetes ICMP Echo (Ping) para eludir firewalls de red estrictos o tráfico TCP/UDP limitado.
⚠️ Nota: Esta herramienta está destinada estrictamente a fines de estudio e investigación. No la utilices para ningún propósito ilegal.

🌟 Características
- Arquitectura de seguridad unificada v3: la antigua clave numérica y los interruptores de cifrado independientes han desaparecido. Una única contraseña compartida (
-password) impulsa la autenticación mutua y el cifrado AEAD de extremo a extremo (por defectochacha20-poly1305, opcionalaes256/aes128). - Múltiples modos:
- Proxy SOCKS5: inicia un proxy SOCKS5 local con un solo comando, con autenticación opcional de nombre de usuario/contraseña;
- Redirección de puertos TCP: accede a un puerto TCP remoto específico (p. ej. SSH, web, RDP);
- Redirección de puertos UDP: redirige tráfico UDP de juegos, DNS 53, etc.;
- Redirección secundaria del lado del servidor (
-forward): el servidor puede retransmitir el tráfico entrante a través de un proxy SOCKS5/HTTP ascendente.
- Configuración flexible (se recomienda el modo de archivo de configuración):
- Ejecuta directamente con un archivo de configuración:
pingtunnel config.jsonopingtunnel -c config.json; config.jsonen el directorio actual se carga automáticamente por defecto;- Los indicadores de línea de comandos siempre sobrescriben los valores correspondientes del archivo de configuración.
- Ejecuta directamente con un archivo de configuración:
- Resistente en redes deficientes: un algoritmo de control de congestión adaptativo al ancho de banda integrado (
bb) suprime el bufferbloat y los bloqueos inducidos por pérdida de paquetes.
🚀 Inicio rápido
Opción 1: Modo de archivo de configuración (Recomendado)
El repositorio incluye archivos de ejemplo. Solo completa la IP de tu servidor y una contraseña segura:
1. Configuración del servidor (config-server.json)
{
"type": "server",
"password": "YOUR_STRONG_PASSWORD_HERE",
"encrypt": "chacha20",
"icmp_listen": "0.0.0.0"
}
Inicie el servidor (requiere privilegios de root / administrador):
sudo ./pingtunnel config-server.json
# or: sudo ./pingtunnel -c config-server.json
2. Configuración del cliente (modo proxy 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"
}
Inicie el cliente:
./pingtunnel config-client-socks5.json
# or: ./pingtunnel -c config-client-socks5.json
Luego configura tu navegador o el proxy del sistema a SOCKS5 127.0.0.1:1080.
Opción 2: Línea de comandos (CLI)
1. Iniciar el servidor
Ejecuta en una máquina con una IP pública:
sudo ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE
(Opcional) Desactiva las respuestas de eco ICMP predeterminadas del kernel de Linux para evitar interferencias:
echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all
2. Iniciar el cliente
- Modo proxy SOCKS5:
./pingtunnel -type client -l 127.0.0.1:1080 -s YOUR_SERVER_IP -socks5 -password YOUR_STRONG_PASSWORD_HERE - Redirección de puertos TCP (modo predeterminado, p. ej., asignar el puerto interno remoto 192.168.1.100:22 al puerto local 2222):
./pingtunnel -type client -l :2222 -s YOUR_SERVER_IP -t 192.168.1.100:22 -password YOUR_STRONG_PASSWORD_HERE - Reenvío UDP (p. ej., puerto local 5353 al DNS público 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
Ejecutar el servidor
docker run --name pingtunnel-server -d \
--restart=always \
--privileged \
--network host \
esrrhs/pingtunnel ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE
Ejecutar con un archivo de configuración montado
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
📖 Guía detallada de uso y ajuste
Para opciones y topologías más avanzadas (proxy secundario del lado del servidor, reenvío de puertos, autenticación SOCKS5, control de flujo y ajuste de congestión), consulte: 👉 USAGE.md - Guía de uso y configuración de Pingtunnel