Installation

Prérequis système

Choisir une variante d'image

L'accélération matérielle pour la détection IA se décline en 4 variantes selon le matériel. Choisir la mauvaise variante ne fait que ralentir ou désactiver la détection ; tout le reste (enregistrement, lecture, audio bidirectionnel) n'est pas affecté. Le script d'installation en une ligne détecte automatiquement votre matériel et choisit la bonne variante pour vous — le tableau ci-dessous n'est qu'une référence pour ceux qui souhaitent choisir manuellement.

Choisir un palier selon le matériel (référence détaillée)

Lors de l'achat d'une nouvelle machine ou de l'évaluation d'une machine existante, utilisez les 5 paliers ci-dessous, regroupés selon la puissance du CPU. Chacun indique l'image recommandée, le nombre de caméras qu'il peut gérer de façon fiable, et les fonctionnalités de détection IA qu'il peut exécuter sans à-coups (vous les activez toujours manuellement dans la console web).

Fonctionnalités de détection que chaque palier peut exécuter sans à-coups

Les paliers supérieurs peuvent activer davantage de fonctionnalités de façon fiable. Sur un palier bas, activer trop de fonctionnalités fait prendre du retard à l'inférence par rapport à la fréquence d'images de la caméra et fait manquer des événements. Le tableau ci-dessous indique les capacités de détection recommandées pour chaque palier — ✅ signifie recommandé, ❌ signifie déconseillé sur ce matériel. Une installation neuve n'active par défaut que la détection d'objets ; tout le reste doit être activé manuellement dans la console web → Paramètres → Détection, selon les besoins.

Déploiement en une ligne (recommandé)

Exécutez une seule commande et le script détecte automatiquement votre matériel, choisit la variante d'image la mieux adaptée, télécharge l'image et démarre le conteneur — 5 à 15 minutes de bout en bout selon votre connexion.

curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash

Ce que fait le script :

• Vérifie que le système est Linux x86_64 avec Docker installé
• Vérifie que les ports tels que 23406 / 23880 / 24214 / 24215 / 23515 sont libres
• Sonde le matériel : GPU NVIDIA (y compris la VRAM) / iGPU Intel / NPU Intel
• Choisit automatiquement la variante d'image la mieux adaptée parmi cpu / openvino / cuda / trt
• Télécharge l'image (depuis Aliyun par défaut) + écrit un fichier docker-compose + génère automatiquement un secret aléatoire fort
• Démarre le conteneur et attend que le contrôle de santé passe (environ 60 secondes)
• Affiche l'URL du navigateur (par exemple http://192.168.1.10:23406/)

Options courantes

# Afficher uniquement la variante recommandée, sans déployer
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash -s -- --detect-only

# Forcer la variante trt et ignorer les invites
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash -s -- --variant trt -y

# Déploiement hors ligne (copiez d'abord l'archive tar.gz de l'image sur la machine via scp)
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh -o install.sh
bash install.sh --offline /path/to/skyview-image.tar.gz

Déploiement par plateforme (choisissez votre appareil)

Le script en une ligne est le plus simple sur un environnement Linux + Docker générique, mais les NAS, HA OS, PVE et plateformes similaires ont chacun leur propre interface de gestion de conteneurs, leur mode réseau, leur méthode de passthrough iGPU et leurs pièges connus. Voici des guides dédiés pour les plateformes cibles courantes, incluant le fichier compose spécifique à chaque plateforme, le chemin de déploiement via l'interface, la configuration du pare-feu et les questions fréquentes :

• Synology DSM 7.2+ — Container Manager + modèles à iGPU Intel (DS920+ / DS423+ / DS224+, etc.)
• Unraid 6.12+ — Compose Manager + plugin Intel GPU TOP / NVIDIA Driver
• fnOS — base Debian 12 + iGPU intégré sur N100/N305
• UGREEN UGOS Pro — modèles x86 (DXP2800/DXP4800/DXP6800, etc.)
• TrueNAS Scale 24.10+ — YAML d'application personnalisée + persistance de dataset ZFS
• Ubuntu / Debian — apt + docker compose v2, le chemin de déploiement le plus simple
• Fedora 39+ — dnf docker-ce + étiquettes de volume SELinux + règles firewalld
• Proxmox VE LXC — LXC privilégié + passthrough iGPU Intel (choix numéro un pour les utilisateurs PVE N100 / N305 à domicile)
• Module complémentaire Home Assistant OS — ajoutez le dépôt SkyView et installez en un clic le module yunkan / yunkan-openvino
• Carte RK3588 — un mini boîtier ARM basse consommation avec accélération NPU Rockchip (Orange Pi 5 / Radxa Rock 5, etc.) ; carte 4 Go recommandée, 8 Go+ expérimental

Déploiement manuel (avancé)

Si vous souhaitez contrôler le processus étape par étape, suivez les 4 étapes ci-dessous. Le script en une ligne n'est essentiellement que ces commandes automatisées.

1. 1

   Télécharger l'image

   Choisissez l'une des quatre variantes ci-dessus :

   bash复制

   docker pull registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-cpu:latest

2. 2

   Créer les répertoires data / recordings

   Les petites données d'état (base de données / cookies / journaux) résident dans data/ ; les enregistrements (pouvant atteindre l'échelle du To) vont dans un répertoire recordings/ voisin, afin que vous puissiez les diriger séparément vers un disque volumineux / NAS.

   bash复制

   mkdir -p ~/skyview/data ~/skyview/recordings && cd ~/skyview

3. 3

   Démarrer le conteneur

   Utilisez le mode réseau hôte pour que les caméras atteignent directement les ports de l'hôte, évitant que le NAT ne dégrade la qualité vidéo. La liaison de licence nécessite de monter /etc/machine-id et product_uuid — ne les omettez pas.

   bash复制

   docker run -d --name yunkan --restart=always \
     --network host \
     -v $(pwd)/data:/app/data \
     -v $(pwd)/recordings:/app/data/recordings \
     -v /etc/machine-id:/etc/machine-id:ro \
     -v /sys/class/dmi/id/product_uuid:/sys/class/dmi/id/product_uuid:ro \
     registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-cpu:latest

4. 4

   Ouvrir le navigateur

   La première visite mène à l'assistant /setup ; poursuivez avec le chapitre Premier lancement.

   复制

   http://<IP du serveur>:23406

Ports et mappage des volumes

SkyView fonctionne en mode réseau hôte, donc tous les ports sont liés directement sur l'hôte. Les ports de production utilisent un décalage inhabituel dans la plage 2xxxx pour éviter les conflits avec un nginx existant sur 80/443, redis sur 6379, ou d'autres services sur 8080/8554/8888.

Mise à niveau

Le plus simple : mise à niveau en un clic depuis la console web. Ouvrez Console web → Paramètres → Système → Rechercher les mises à jour, puis cliquez sur « Mettre à niveau » lorsqu'une nouvelle version apparaît : le système télécharge la nouvelle image et recrée le conteneur automatiquement (la base de données est sauvegardée au préalable, et si la nouvelle version ne démarre pas, un retour arrière automatique est effectué). La page se reconnecte à la nouvelle version en quelques minutes.

Vous pouvez aussi mettre à niveau manuellement via SSH :

cd ~/skyview
docker compose -f compose.yml pull
docker compose -f compose.yml up -d

Ou relancez le script en une ligne (avec -y pour ignorer les invites) :

curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash -s -- -y

Désinstallation

cd ~/skyview
docker compose -f compose.yml down
docker rmi registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-cpu:latest
# Les enregistrements / la base de données sont conservés ; pour un nettoyage complet :
rm -rf ~/skyview