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	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
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, 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)