🔍 Dépannage

Ce guide couvre les problèmes courants que vous pouvez rencontrer en travaillant avec ShredStream.com et comment les résoudre.

Vous construisez votre propre récepteur de shreds bruts ? Le parsing et la validation des paquets sont à votre charge. Les problèmes réseau ci-dessous (pare-feu, IP, buffers) s'appliquent dans tous les cas — y compris avec le client Decoded Shred Stream.


❌ Aucune donnée reçue

Si votre écouteur UDP est en cours d'exécution mais qu'aucun shred n'arrive :

  1. Vérifiez votre pare-feu -- Assurez-vous que votre pare-feu autorise le trafic UDP entrant sur le port que vous avez configuré. Sous Linux :
    bash
    sudo ufw allow <port>/udp
  2. Vérifiez que le stream est actif -- Ouvrez votre Tableau de bord et confirmez que le statut du stream affiche Actif. Les streams expirés ou en pause n'envoient pas de données. Si le stream affiche Provisionnement ou Error, patientez un instant et rafraîchissez. Si le statut ne change pas, contactez le support sur Discord.
  3. Confirmez que votre IP correspond -- L'IP de destination de votre stream doit correspondre exactement à l'IP publique de votre serveur. Vous pouvez vérifier votre IP publique avec :
    bash
    curl -4 ifconfig.me
  4. Liez à 0.0.0.0 -- Assurez-vous que votre socket UDP se lie à 0.0.0.0, et non à 127.0.0.1 ou à l'IP d'une interface spécifique. Se lier à localhost rejettera silencieusement tout le trafic externe.

📉 Perte élevée de paquets

Les shreds arrivent via UDP, qui ne retransmet pas les paquets perdus. Minimiser les pertes est essentiel.

  1. Augmentez votre tampon de réception UDP à au moins 25 Mo :

    bash
    # Check current value
    sysctl net.core.rmem_max
    # Set to 25 MB
    sudo sysctl -w net.core.rmem_max=26214400
    sudo sysctl -w net.core.rmem_default=26214400

    Remarque : Linux double la valeur que vous définissez via setsockopt(). Si vous demandez 25 Mo, le noyau alloue 50 Mo. La valeur sysctl est la limite supérieure avant le doublement.

  2. Choisissez une région plus proche -- La latence et la perte de paquets augmentent avec la distance. La région est choisie à la création du stream ; si votre stream est éloigné de votre serveur, créez un nouveau stream dans la région la plus proche de celui-ci.

  3. Évitez les E/S bloquantes dans votre boucle de réception -- Tout délai de traitement dans le thread qui appelle recvfrom() provoque le remplissage du tampon du noyau et la perte de paquets. Déléguez l'analyse et la logique à un thread séparé.

  4. Surveillez les pertes au niveau du noyau :

    bash
    # Per-socket drops (Linux)
    ss -u -a -n
    # System-wide UDP stats
    netstat -su

    Recherchez le compteur RcvbufErrors ou packet receive errors. Si ce nombre augmente, votre tampon est trop petit ou votre application ne lit pas assez vite.


💳 Paiement non confirmé

Les paiements sont traités sur la blockchain Solana. Si votre paiement semble bloqué :

  1. Attendez 30 à 60 secondes -- Les transactions Solana sont généralement confirmées en quelques secondes, mais la congestion du réseau peut causer des délais.
  2. Vérifiez le compte à rebours -- Le montant en SOL est verrouillé pour une durée limitée. Si le paiement apparaît comme expiré, cliquez sur Refresh Payment pour obtenir un montant actualisé ; le SOL déjà envoyé est tout de même détecté automatiquement.
  3. Assurez-vous d'avoir envoyé suffisamment de SOL -- Le montant envoyé doit correspondre au montant complet affiché dans la fenêtre de paiement. Si vous payez depuis un exchange, tenez compte des frais de retrait pour que le montant complet arrive à l'adresse de paiement.

Si la transaction a échoué on-chain, vous pouvez retenter le paiement depuis votre tableau de bord. Toujours bloqué ? Contactez-nous sur Discord avec votre identifiant de paiement.


⚠️ Stream arrêté de manière inattendue

Si un stream qui fonctionnait précédemment a cessé de livrer des données :

  1. Vérifiez la date d'expiration -- Ouvrez la page de détail du stream sur votre tableau de bord. Si le stream a expiré, renouvelez-le pour reprendre la livraison.
  2. Vérifiez le statut de la région -- Occasionnellement, une région peut faire l'objet d'une maintenance. Consultez le tableau de bord pour toute notification de statut de région.
  3. Contactez le support -- Si le stream affiche comme actif et que la région est opérationnelle, ouvrez un ticket sur Discord dans le canal #ticket pour obtenir de l'aide.

🔌 Problèmes de connexion

Si vous ne parvenez pas à configurer un stream ou si vous voyez des erreurs de connectivité :

  1. Utilisez une adresse IPv4 publique -- ShredStream.com livre les données uniquement vers des IP publiques. Les plages privées ne fonctionneront pas :
    • 10.0.0.0/8
    • 172.16.0.0/12
    • 192.168.0.0/16
  2. Utilisez un port entre 1024 et 65535 -- Les ports inférieurs à 1024 sont réservés et peuvent nécessiter des privilèges root ou être bloqués par les fournisseurs d'hébergement.
  3. Assurez-vous qu'aucun NAT ne bloque le trafic UDP entrant -- Si votre serveur se trouve derrière une passerelle NAT (courant chez les fournisseurs cloud), assurez-vous que le NAT ou le groupe de sécurité redirige le trafic UDP sur le port choisi vers votre instance.

💬 Besoin d'aide supplémentaire ?

Si aucune des solutions ci-dessus ne résout votre problème, contactez notre équipe de support :

  • Discord (le plus rapide) : Ouvrez un ticket dans le canal #ticket
  • Telegram : @shredstream

Incluez votre identifiant de stream, la région du serveur et une description du problème afin que nous puissions vous aider rapidement.

Dépannage — Docs | ShredStream.com