
NAT Tunnel : pour servir sans effort depuis derrière un NAT
REMARQUE : l'ancienne version Python est définitive et non maintenue. Ses instructions se trouvent à la fin de ce fichier. Elle est incompatible avec la version C actuelle. Utilisez uniquement la version C.
Si vous avez accès à un serveur avec une IP publique et des ports non filtrés, vous pouvez exécuter le serveur NAT Tunnel (NT) sur le serveur, et le client NT sur votre machine derrière un NAT. Le serveur nécessite 2 ports ouverts : un pour la communication avec le client NT (--admin), l'autre pour que les clients réguliers puissent s'y connecter (--public : c'est le port que vous voulez que vos utilisateurs utilisent).
Le client NT ouvre une connexion vers l'ip/port admin du serveur. Dès que le serveur reçoit une nouvelle connexion, il signale au client NT, qui crée alors une nouvelle connexion tunnel vers le serveur, laquelle est ensuite connectée au service souhaité du côté du client NT (--local)
La connexion entre le client NT et le serveur NT sur l'interface admin est protégée par un secret partagé contre toute utilisation non autorisée. Un adversaire capable d'intercepter les paquets pourrait casser le secret s'il n'est pas suffisamment complexe. Au moins 10 caractères aléatoires et chiffres sont recommandés.
Exemple : Vous avez un serveur HTTP en écoute sur votre machine locale sur le port 80. Vous voulez le rendre disponible sur l'IP publique de votre serveur cloud/VPS/etc. sur le port 8000. Nous utilisons le port 7000 sur le serveur cloud pour le canal de contrôle.
Serveur :
./natsrv --mode server --secret-file secret.txt --server-key server.key --public 0.0.0.0:8000 --admin 0.0.0.0:7000
Client :
./natsrv --mode client --secret-file secret.txt --server-pubkey PUBKEY_HEX --local localhost:80 --admin example.com:7000
IPv4 et IPv6 fonctionnent partout. La syntaxe d'adresse est host:port. Pour les littéraux IPv6, utilisez des crochets : [::1]:8080, [2001:db8::1]:7000. Une adresse IPv6 nue sans crochets est rejetée, car les deux-points rendent le port ambigu. Pour les noms d'hôtes, IPv4 est préféré et IPv6 est le repli ; un littéral numérique explicite l'emporte toujours pour sa propre famille. L'adresse d'écoute 0.0.0.0 signifie toutes les interfaces IPv4, :: signifie toutes les interfaces IPv6. Sur le réseau, le serveur rapporte un pair sous la forme ip:port pour IPv4 et [ip]:port pour IPv6, et les deux côtés analysent les deux formes.
Générez une fois la clé de signature du serveur :
./natsrv --genkey server.key
Cela écrit la clé privée avec les permissions 0600 et affiche la clé publique en hexadécimal. Donnez cette chaîne hexadécimale au client via --server-pubkey. Le serveur exige --server-key, le client exige --server-pubkey. Préférez --secret-file PATH à --secret sur les machines partagées, car --secret fuit via ps aux.
Compilez avec GNU Make standard (3.82 ou plus récent) :
make
Cela produit ./natsrv. Le Makefile commence par -include config.mak avant la première cible, afin qu'un fichier local config.mak puisse définir de façon permanente CFLAGS, CPPDFGS, LDFLAGS, et autres. Le Makefile ajoute ses propres valeurs par défaut avec CFLAGS += -Wall -std=c99. Les options sur la ligne de commande de Make sont également transmises :
make CPPFLAGS=-DHAVE_GETRANDOM
make CFLAGS="-Wall -Wextra -std=c99 -pedantic"
make USE_SODIUM=1
make clean
HAVE_GETRANDOM : par défaut, l'aléa provient de /dev/urandom. Définissez HAVE_GETRANDOM pour utiliser plutôt l'appel système getrandom() (Linux 3.17+ / glibc 2.25+). Les deux chemins échouent de façon sûre. L'édition de liens utilise -lpthread par défaut, plus -lsodium avec USE_SODIUM=1. Le code lui-même est en C99 et portable, sans extensions GNU99. Des tabulations sont utilisées pour l'indentation, conformément au style de code de microsocks.
Le chiffrement du tunnel utilise XSalsa20. Par défaut, il est fourni par le code TweetNaCl intégré (tweetnacl.c, tweetnacl.h). Avec USE_SODIUM=1, il se lie à libsodium à la place. Le code sha256 dans sha256.c est écrit de zéro ; aucune bibliothèque cryptographique n'est nécessaire pour la compilation par défaut.
Sur x86 avec les extensions Intel SHA, sha256.c utilise automatiquement les intrinsèques SHA-NI lorsque le compilateur définit SHA et SSSE3. L'implémentation scalaire reste le repli. Activez-la sans -march=native :
make CPPFLAGS="-msha -msse4.1"
Cela produit un binaire qui nécessite n'importe quel CPU x86 avec prise en charge de SHA-NI et SSE4.1, sans autres fonctionnalités de -march=native. Un simple make sans ces options fonctionne toujours partout.
Mesuré sur un i7-1160G7, SHA256 brut de blocs de 16 Kio : scalar -O2 est d'environ 257 Mo/s, SHA-NI -O2 est d'environ 1574 Mo/s (environ 6 fois plus rapide).
Les sockets de tunnel ont des délais d'attente d'envoi et de réception, définis avec --timeout SECS (par défaut 1800, 0 les désactive). La valeur par défaut est délibérément prudente : un serveur lent tel que llama.cpp en dessous de 10 jetons par seconde, ou un envoi massif de prompt système, peut légitimement bloquer pendant plusieurs minutes. Des valeurs plus courtes tuent ces tunnels ; des valeurs plus longues retardent la détection d'un socket mort. Les sockets de contrôle n'ont jamais le délai d'attente, donc une connexion de contrôle inactive n'est pas tuée.
Tous les sockets utilisent le keepalive TCP avec des sondes toutes les 30 secondes d'inactivité (intervalle de 5 secondes, 3 sondes), de sorte qu'un pair silencieusement mort est détecté en environ 45 secondes au lieu du délai par défaut de 2 heures.
Le client et le serveur exécutent tous deux une boucle poll. Aucune extrémité ne bloque dans accept. Le client interroge le socket de contrôle et le socket de réserve ensemble, et il réarme la réserve lorsque la réserve présente des données, une erreur, ou échoue au contrôle de mort toutes les 5 secondes. Le serveur interroge l'écouteur d'administration, l'écouteur public, le socket de contrôle et le socket de réserve ensemble. Par conséquent, le serveur dessert le port public alors qu'il n'a pas de réserve, et il n'arrête jamais de surveiller le socket de contrôle.
Une connexion publique qui arrive alors qu'aucune réserve active n'existe est réinitialisée immédiatement. Le pair voit un échec, pas un blocage. Une réserve qui présente déjà FIN ou RST est abandonnée et réarmée avant d'être appariée, de sorte qu'une réserve morte n'atteint jamais un tunnel. Des données lisibles seules ne sont pas traitées comme mort sur une réserve sur le point d'être appariée, puisque des octets de tunnel peuvent légitimement être en transit.
Exécutez toute la suite avec :
make test
Cela nécessite python3 et compile natsrv d'abord. La suite démarre de vrais processus serveur et client sur des ports loopback. Chaque test obtient ses propres ports, répertoire de travail et journaux, de sorte qu'un échec ne fuit jamais dans le test suivant.
Les tests peuvent être sélectionnés par nom, et listés :
python3 tests/natt.py --list
python3 tests/natt.py spare_rst control_rst