
pingtunnel master-d7cd0d6ab5f18e7d8d050385e8d240b3b2f41e6c
Pingtunnel est un outil qui envoie du trafic TCP/UDP via ICMP.
Pingtunnel
Pingtunnel est un outil réseau qui tunnelise le trafic TCP/UDP/SOCKS5 via des paquets ICMP Echo (Ping) afin de contourner les pare-feu réseau stricts ou le trafic TCP/UDP limité.
⚠️ Remarque : Cet outil est strictement destiné à des fins d'étude et de recherche. Ne l'utilisez pas à des fins illégales.

🌟 Fonctionnalités
- Architecture de sécurité unifiée v3 : l'ancienne clé numérique et les commutateurs de chiffrement séparés ont disparu. Un unique mot de passe partagé (
-password) pilote l'authentification mutuelle et le chiffrement AEAD de bout en bout (par défautchacha20-poly1305, en optionaes256/aes128). - Modes multiples :
- Proxy SOCKS5 : démarrez un proxy SOCKS5 local en une seule commande, avec authentification par nom d'utilisateur/mot de passe en option ;
- Redirection de port TCP : atteindre un port TCP distant spécifique (par ex. SSH, web, RDP) ;
- Redirection de port UDP : rediriger le trafic UDP de jeux, DNS 53, etc. ;
- Redirection secondaire côté serveur (
-forward) : le serveur peut relayer le trafic entrant via un proxy SOCKS5/HTTP en amont.
- Configuration flexible (mode fichier de configuration recommandé) :
- Exécution directe avec un fichier de configuration :
pingtunnel config.jsonoupingtunnel -c config.json; - Le fichier
config.jsondu répertoire courant est chargé automatiquement par défaut ; - Les options de ligne de commande remplacent toujours les valeurs correspondantes du fichier de configuration.
- Exécution directe avec un fichier de configuration :
- Résilient sur les réseaux dégradés : un algorithme de contrôle de congestion adaptatif à la bande passante intégré (
bb) supprime le bufferbloat et les blocages induits par la perte de paquets.
🚀 Démarrage rapide
Option 1 : Mode fichier de configuration (recommandé)
Des fichiers d'exemple sont fournis avec le dépôt. Il suffit de renseigner l'IP de votre serveur et un mot de passe robuste :
1. Configuration serveur (config-server.json)
{
"type": "server",
"password": "YOUR_STRONG_PASSWORD_HERE",
"encrypt": "chacha20",
"icmp_listen": "0.0.0.0"
}
Démarrez le serveur (nécessite des privilèges root / administrateur) :
sudo ./pingtunnel config-server.json
# or: sudo ./pingtunnel -c config-server.json
2. Configuration du client (mode 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"
}
Démarrez le client :
./pingtunnel config-client-socks5.json
# or: ./pingtunnel -c config-client-socks5.json
Ensuite, configurez le proxy de votre navigateur ou de votre système sur SOCKS5 127.0.0.1:1080.
Option 2 : Ligne de commande (CLI)
1. Démarrer le serveur
Exécutez sur une machine disposant d'une IP publique :
sudo ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE
(Facultatif) Désactiver les réponses d'écho ICMP par défaut du noyau Linux pour éviter les interférences :
echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all
2. Démarrer le client
- Mode proxy SOCKS5 :
./pingtunnel -type client -l 127.0.0.1:1080 -s YOUR_SERVER_IP -socks5 -password YOUR_STRONG_PASSWORD_HERE - Redirection de port TCP (mode par défaut, par exemple mapper le port interne distant 192.168.1.100:22 vers le port local 2222) :
./pingtunnel -type client -l :2222 -s YOUR_SERVER_IP -t 192.168.1.100:22 -password YOUR_STRONG_PASSWORD_HERE - Redirection UDP (par exemple, port local 5353 vers le DNS public 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
Lancer le serveur
docker run --name pingtunnel-server -d \
--restart=always \
--privileged \
--network host \
esrrhs/pingtunnel ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE
Exécuter avec un fichier de configuration monté
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
📖 Guide détaillé d'utilisation et de réglage
Pour des options et topologies plus avancées (proxy secondaire côté serveur, redirection de ports, authentification SOCKS5, contrôle de flux et réglage de la congestion), voir : 👉 USAGE.md - Guide d'utilisation et de configuration de Pingtunnel