# Dépannage

Lorsque vous rencontrez un problème, commencez par le comparer aux symptômes de ce chapitre. Si aucun ne correspond, contactez-nous via « Obtenir de l'aide » à la fin.

## 1. Pas de vidéo (le direct reste en mémoire tampon)

| Cause possible | Comment vérifier | Solution |
| --- | --- | --- |
| URL RTSP incorrecte | Essayez la même URL dans VLC | Modifiez l'URL et réenregistrez ; si la découverte automatique ONVIF renvoie une mauvaise adresse, passez au RTSP manuel |
| Identifiants incorrects | Le Web Admin signale un échec d'authentification | Allez dans les détails de la caméra et changez le mot de passe ; le mot de passe ONVIF ≠ le mot de passe RTSP |
| Canal à faible latence bloqué | DevTools → Réseau affiche une erreur de connexion | Ouvrez l'UDP 23515 dans le pare-feu ; si ce n'est pas possible, il bascule automatiquement sur le canal stable (2 à 4 s de latence) |
| La caméra utilise un protocole propriétaire (Tapo / Xiaomi) | La marque de la caméra ne figure pas dans la liste [Caméras](/docs/cameras) | Utilisez un pont go2rtc |
| La passerelle de streaming n'a pas démarré | `docker logs yunkan` pour voir les erreurs de démarrage | Généralement un conflit de port ; essayez de redémarrer le conteneur |

## 2. La lecture est noire / la barre de progression ne bouge pas

- **L'enregistrement n'est pas activé** : Détails de la caméra → Paramètres d'enregistrement → activer
- **Disque plein** : `df -h` pour vérifier la partition contenant les données, puis supprimez les anciens enregistrements ou réduisez le nombre de jours de rétention
- **Segment d'enregistrement corrompu** : trouvez le fichier correspondant `data/recordings/<id>/<date>/<HH-MM-SS>.mp4` et essayez de le lire dans VLC ; un segment corrompu ne fait perdre que 5 minutes au maximum
- **Heure incorrecte** : si les fuseaux horaires du serveur et de la caméra sont désynchronisés, la frise de lecture est décalée de 8 heures ; vérifiez avec `timedatectl`

## 3. La détection IA ne fonctionne pas

| Symptôme | Cause | Solution |
| --- | --- | --- |
| La page des événements reste vide | Le commutateur global de détection est désactivé | Paramètres → Détection → activer |
| Une caméra ne détecte pas | Cette caméra a un statut « échec de détection » | Détails de la caméra → « Effacer l'erreur de détection » |
| GPU à 0 % d'utilisation | Mauvaise variante d'image (exécution de l'image cpu sur une machine avec GPU) | Récupérez l'image de la variante correspondante et redémarrez |
| Les visages sont toujours « Inconnu » | Cette personne n'a jamais été ajoutée / le seuil est trop strict | Ajoutez le visage / abaissez le seuil de similarité faciale |
| Nombreuses fausses alertes de chute | Le seuil de vitesse de descente est trop bas | Augmentez un peu le seuil de vitesse de descente de chute |

## 4. Le conteneur redémarre sans cesse

Utilisez `docker logs --tail 200 yunkan` pour voir les dernières sorties. Erreurs courantes :

- **Configuration manquante** : en mode assistant mais le contrôle de santé échoue → terminez simplement l'assistant /setup dans le navigateur
- **Port déjà utilisé** : `ss -tnlp | grep 23406`, puis arrêtez le service en conflit ou changez de port
- **Fichiers matériels non montés** : le bind-mount n'incluait pas `/etc/machine-id`, ce qui fait planter la validation de licence ; ajoutez-le selon [Installation](/docs/install)
- **Architecture non prise en charge** : SkyView ne publie que des images x86_64 et ne peut pas fonctionner sur des machines ARM (`uname -m` devrait afficher `x86_64`)

## 5. L'envoi vers 115 échoue

- **Connexion expirée** (environ 30 jours) : Paramètres → 115 → rescannez pour vous reconnecter
- **VIP expiré** : les très gros fichiers nécessitent le canal d'envoi instantané du VIP 115 ; les non-VIP utilisent un canal à débit limité
- **Dossier cible supprimé** : recréez le dossier dans 115, puis revenez dans SkyView et resélectionnez-le
- **Réseau instable** : les tâches d'envoi disposent de reprises intégrées ; consultez `docker logs yunkan` pour l'erreur précise

## 6. L'automatisation ne se déclenche pas

- **Heures silencieuses** : Paramètres → Notifications → Heures silencieuses, vérifiez si vous êtes actuellement dans cette plage
- **Délai de rappel (cooldown)** : les événements répétés en moins de 30 secondes sont ignorés ; réduisez le délai de rappel ou utilisez un autre type d'événement
- **Condition non satisfaite** : la règle a ajouté « personne reconnue = Zhang San » mais elle a en fait été reconnue comme « Inconnu », donc la règle ne se déclenche pas ; assouplissez la condition
- **MQTT non connecté** : Paramètres → Intégrations → MQTT pour vérifier l'état de la connexion, et vérifiez l'adresse / les identifiants

## 7. L'assistant réapparaît après une mise à niveau / les données ont disparu

Être redirigé vers /setup après une mise à niveau vient presque toujours du fait que le **répertoire de données n'a pas été monté correctement** — le conteneur ne voit pas le fichier de configuration écrit précédemment, donc il suppose une installation neuve. Vérifiez :

```bash
docker inspect yunkan | grep -A 2 Mounts
# Vous devriez voir Source: /home/.../data, Destination: /app/data
# Si le chemin a changé / n'est pas monté, faites un docker rm du conteneur et montez-le correctement au prochain docker run
```

> **🛑 Ne repassez jamais par l'assistant**
>
> Repasser par la configuration écrit une nouvelle base de données vide ; l'originale est toujours là mais désactivée. Arrêtez d'abord le conteneur, corrigez le montage, puis redémarrez — vous entrerez directement en mode normal.

## 8. Comment lire les journaux

```bash
# Déploiement en image unique : tous les journaux sont mélangés
docker logs --tail 500 -f yunkan

# Pour ne voir que ce qui concerne la détection :
docker logs yunkan 2>&1 | grep -i detection

# Déploiement multi-conteneurs : chaque composant est séparé
docker compose logs -f api detection
```

## Obtenir de l'aide

- **Ticket de support** : [Portail client → Mes commandes → Ouvrir un ticket](/portal/tickets/new), joignez la sortie de `docker logs --tail 200 yunkan`, suivi le plus rapide
- **E-mail** : support@yun-kan.com (réponse sous 24 heures)
- **Groupe WeChat** : après l'achat, la page « Mes commandes » du portail client contient un QR code de groupe (utilisateurs payants uniquement)

---

来源:https://yun-kan.com/fr/docs/troubleshooting