🌐 Configuration réseau

Avant que votre serveur puisse recevoir des shreds — que ce soit via notre SDK ou un listener UDP brut — vous devez ouvrir le port approprié et ajuster les tampons réseau de votre système d'exploitation.

Vous utilisez notre SDK ? Le SDK configure automatiquement le tampon de réception du socket. Vous devez quand même effectuer les étapes de configuration du pare-feu et d'optimisation OS ci-dessous.

🔒 Configuration du pare-feu

Ouvrez le port UDP que vous avez configuré sur ShredStream.com. La commande exacte dépend de votre distribution Linux.

🔹 UFW (Ubuntu / Debian)

bash

sudo ufw allow 8001/udp

🔹 iptables

bash

sudo iptables -A INPUT -p udp --dport 8001 -j ACCEPT

Pour conserver la règle après un redémarrage, sauvegardez-la avec iptables-save ou le mécanisme de persistance de votre distribution (par exemple, netfilter-persistent).

🔹 firewalld (CentOS / RHEL / Fedora)

bash

sudo firewall-cmd --permanent --add-port=8001/udp
sudo firewall-cmd --reload

Si votre serveur se trouve derrière un groupe de sécurité d'un fournisseur cloud (AWS, GCP, Azure, etc.), vous devez également autoriser le trafic UDP entrant sur le même port dans la console cloud.

📐 Ajustement des tampons UDP

Les validateurs Solana produisent des shreds à un débit très élevé. Le tampon de réception UDP par défaut sous Linux est généralement de 256 Ko, ce qui est bien trop petit et entraînera des pertes de paquets. Configurez le tampon à au moins 25 Mo.

⚡ Appliquer immédiatement

bash

# Linux
sudo sysctl -w net.core.rmem_max=26214400
sudo sysctl -w net.core.rmem_default=26214400

# macOS
sudo sysctl -w kern.ipc.maxsockbuf=33554432

💾 Rendre persistant après redémarrage

bash

echo 'net.core.rmem_max=26214400' | sudo tee -a /etc/sysctl.conf
echo 'net.core.rmem_default=26214400' | sudo tee -a /etc/sysctl.conf

Puis vérifiez :

bash

sysctl net.core.rmem_max net.core.rmem_default

Ne pas ajuster les tampons est la cause la plus fréquente de shreds manqués. Si votre écouteur signale des lacunes dans les données, vérifiez vos paramètres de tampon en priorité.

✅ Vérification de votre configuration

Une fois votre listener SDK en cours d'exécution et votre stream actif sur le tableau de bord, vous devriez voir des résultats en quelques secondes.

Liste de vérification si les shreds n'arrivent pas :

Statut du tableau de bord — confirmez que votre stream affiche Actif et que l'IP et le port correspondent.
Pare-feu — vérifiez que le port UDP est ouvert. Testez depuis une autre machine avec nc -u <votre-ip> 8001.
IP publique — assurez-vous d'avoir saisi l'adresse IPv4 publique, et non une adresse privée.
Taille du tampon — exécutez sysctl net.core.rmem_max pour confirmer la valeur.
Liaison de l'écouteur — assurez-vous que votre écouteur se lie à 0.0.0.0, et non à 127.0.0.1.

Si tout est en ordre et que vous ne recevez toujours pas de données, consultez le Dépannage ou contactez l'équipe sur Discord.