Guide : héberger Nodyx depuis chez soi avec Nodyx Relay

Héberger son instance à la maison — sans ouvrir de ports

Raspberry Pi aucun port

La situation typique

• Box FAI avec CGNAT (courant en 4G/5G, de plus en plus en fibre)
• IP dynamique qui change régulièrement
• Pas envie de payer pour un VPS

Installation

bash <(curl -fsSL https://raw.githubusercontent.com/Pokled/Nodyx/main/install_tunnel.sh)

Ou sur une instance déjà installée :

nodyx-relay client \
  --server relay.nodyx.org:7443 \
  --slug votre-slug \
  --token votre-token \
  --local-port 80

Résultat : votre instance accessible sur https://votre-slug.nodyx.org

Points techniques importants

• Reconnexion automatique avec backoff exponentiel 1s → 2s → 4s → max 30s
• Compatible Socket.IO long-polling et WebSocket
• TLS géré par Cloudflare — pas besoin de certificat local
• Le relay ne voit que le trafic HTTP en transit — pas de déchiffrement

Recommandé pour

• 🍓 Raspberry Pi 4 (4GB+)
• NAS Synology / QNAP
• Mini-PC maison (NUC, Beelink...)
• VM locale sur un serveur de gaming

Testé sur un Pi 4 derrière une box Orange. Pas de port ouvert, IP dynamique. La reconnexion automatique fonctionne à chaque redémarrage du Pi.

J'ai même coupé le Pi pendant 2h et la reconnexion au relay s'est faite en moins de 30 secondes au redémarrage.

Le point sur le TLS Cloudflare est important à comprendre : CF gère le chiffrement entre le visiteur et CF, mais le trafic entre CF et votre machine passe via le relay en clair (sur localhost).

Pour des données très sensibles, ajouter un certificat SSL local en plus. Pour un usage communauté normale, le schéma actuel est très bien.