OSIADocs
Préversion
VérifiéVérifié le 2026-08-07

Dépanner la connexion

Diagnostic sûr et ordonné du PC, de l’association, du LAN, de WebRTC et du relais.

#Diagnostic en cinq couches

  1. 1
    PC: vérifier que le serveur OSIA est actif et que le chat local répond.
  2. 2
    Association: vérifier que le téléphone possède une association actuelle; régénérer seulement si elle est obsolète ou compromise.
  3. 3
    LAN: même réseau privé non invité, service mDNS et règle Private LocalSubnet.
  4. 4
    WebRTC: vérifier l’accès STUN/UDP sans attendre une réussite sur tout NAT.
  5. 5
    Relais: vérifier l’accès HTTPS/WebSocket et l’état du service.

#Symptômes

SymptômePisteAction sûre
LAN absent, relais fonctionneIsolation Wi-Fi, mDNS ou règle privéeTester un réseau privé commun; ne pas ouvrir le routeur.
WebRTC échoue, relais fonctionneNAT/UDP/pare-feuAccepter le relais; tester un autre réseau pour confirmer.
Tous les chemins échouentPC arrêté, association, DNS ou accès relaisRevenir couche par couche depuis le PC.
Coupure pendant réponseChangement réseau ou veilleReconnecter puis relire l’historique; ne pas attendre un renvoi automatique.
Ancien téléphone connectéSession autoritative remplacéeDéconnecter et régénérer l’association si nécessaire.

#Contournements à éviter

  • Ne pas ouvrir 8766 sur Internet.
  • Ne pas créer de transfert de port.
  • Ne pas mettre la règle pare-feu en Public ou Any.
  • Ne pas désactiver durablement antivirus ou pare-feu.
  • Ne pas publier le secret d’association, l’adresse, l’empreinte ou les journaux bruts.

#Rapport utile

Conservez la date, les versions PC/mobile, le transport attendu, l’étape de l’échec et une erreur expurgée. Remplacez les adresses, identifiants, empreintes et contenus par des catégories neutres avant partage.

Provenance de cette page

Faits produit vérifiés sur PC 7b6b3b000b89, mobile d492cc89cf77 et Worker f07e239bd455.

Sources consultées
  • PC: docs/webrtc-direct.md
  • Mobile: lib/services/transport/
  • Worker: src/relay.js et src/relay_policy.js