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 RK3588 (arm64) ; les autres machines ARM ne peuvent pas l'exécuter (uname -m devrait afficher x86_64 ; si elle affiche aarch64, seules les cartes RK3588 fonctionnent — voir Déploiement RK3588)

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. Mot de passe oublié, connexion impossible

Commencez par identifier votre cas :

Situation	Que faire
Vous connaissez le mot de passe et voulez simplement le changer	Connectez-vous, puis allez dans Paramètres → Utilisateurs
Un membre de la famille a oublié le sien	Demandez à un administrateur de le réinitialiser dans Paramètres → Utilisateurs
L'administrateur l'a oublié et plus personne ne peut entrer	Utilisez la commande ci-dessous

SkyView fonctionne sur votre propre machine : il n'existe donc pas d'e-mail de réinitialisation. Si l'administrateur ne peut plus se connecter, exécutez la commande ci-dessous sur la machine où SkyView est installé. Toute personne pouvant utiliser cette machine en a de toute façon déjà le contrôle complet.

bash

# Voir les comptes existants
docker exec -it yunkan skyview-reset-password --list

# Réinitialiser un compte. Le nouveau mot de passe est demandé deux fois (il ne s'affiche pas à l'écran)
docker exec -it yunkan skyview-reset-password --user admin

Règles du mot de passe

Au moins 8 caractères, avec des lettres et des chiffres - la même règle que sur le site.

Si ce compte a été désactivé, réinitialiser le mot de passe ne suffit pas à le reconnecter. Ajoutez --activate pour le réactiver en même temps :

bash

docker exec -it yunkan skyview-reset-password --user admin --activate

Si votre conteneur ne s'appelle pas yunkan

yunkan est le nom de conteneur par défaut créé par le script d'installation. Si vous avez installé depuis le magasin d'applications d'un NAS ou comme module complémentaire Home Assistant, le nom peut différer. Lancez docker ps pour le vérifier, puis remplacez yunkan dans les commandes ci-dessus.

Réinitialiser un mot de passe ne déconnecte personne

Les téléphones et navigateurs déjà connectés continuent de fonctionner jusqu'à l'expiration de leur session. Si vous craignez qu'un tiers y ait accès, désactivez ou supprimez ce compte dans Paramètres → Utilisateurs.

9. 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)

Cette page vous a-t-elle été utile ?