Déploiement sur Unraid

Voie recommandée : installation en un clic (Community Applications)

Community Applications d'Unraid (appelé CA en abrégé, l'onglet Apps) est un magasin d'applications maintenu par la communauté. SkyView y est référencé officiellement, si bien que les utilisateurs d'Unraid peuvent simplement rechercher « yunkan » dans Apps et l'installer en un clic — aucun dépôt de modèle à ajouter, une expérience équivalente à celle de l'add-on Home Assistant. Pas de compose à écrire à la main, pas de SSH.

1. 1

   Vérifier que le plugin Community Applications est installé

   Unraid 6.10+ l'inclut généralement par défaut. Si l'onglet Apps est visible, c'est bon. S'il manque, allez dans Plugins → Install Plugin et collez https://raw.githubusercontent.com/Squidly271/community.applications/master/plugins/community.applications.plg pour l'installer.

2. 2

   Rechercher et installer (choisissez-en une seule ; les conflits de ports empêchent d'en installer plusieurs)

   Onglet Apps → tapez yunkan dans la recherche → 3 variantes apparaissent : YunKan (CPU uniquement, aucune dépendance matérielle) / YunKan-OpenVINO (iGPU Intel, installez d'abord le plugin Intel GPU TOP) / YunKan-CUDA (GPU NVIDIA, installez d'abord le plugin NVIDIA Driver). Cliquez sur Install sur la variante correspondante ; les valeurs par défaut conviennent, avec un répertoire de données par défaut à /mnt/user/appdata/yunkan/data.

3. 3

   Premier démarrage → assistant de configuration

   Une fois le conteneur démarré, trouvez le conteneur yunkan dans l'onglet Docker → cliquez sur WebUI (ou ouvrez directement http://<Unraid IP>:23406/) → accédez à l'assistant de configuration → choisissez SQLite → créez un administrateur → ajoutez une caméra.

Ou : la voie docker compose (personnalisation / Unraid ancien)

Voici la voie de déploiement traditionnelle avec un compose écrit à la main, pour les utilisateurs ayant besoin de ports personnalisés ou utilisant Unraid < 6.12 sans le plugin CA. Si vous avez utilisé l'installation en un clic via CA ci-dessus, vous pouvez ignorer cette section et passer directement à l'installation du plugin GPU dans 2. Prérequis, ou aller directement à 5. Ports et pare-feu / 6. FAQ.

1. Matériel pris en charge et variante recommandée

2. Prérequis

1. 1

   Vérifier la version d'Unraid

   Tools → Update OS, vérifiez que la version est ≥ 6.12.13 (les versions plus anciennes nécessitent le plugin Docker Compose Manager)

2. 2

   Installer le plugin GPU

   Dans l'onglet Apps, recherchez le plugin correspondant : installez Intel GPU TOP pour un iGPU Intel, NVIDIA Driver pour NVIDIA ; un redémarrage sera demandé après l'installation, après quoi /dev/dri ou /dev/nvidia* apparaît

3. 3

   Créer le répertoire AppData

   Unraid utilise par convention /mnt/user/appdata/yunkan/ ; créez-le puis placez-vous dedans pour y déposer le fichier compose

3. Récupérer le fichier compose

Choisissez l'une des trois méthodes : téléchargement depuis le navigateur, wget via SSH, ou coller la version minimale dans le Compose Manager d'Unraid :

Ou connectez-vous en SSH à Unraid (ou utilisez le plugin Terminal) :

ssh root@<Unraid IP>
mkdir -p /mnt/user/appdata/yunkan
cd /mnt/user/appdata/yunkan
wget https://yun-kan.com/compose/unraid.yml -O compose.yml

name: yunkan

services:
  yunkan:
    image: registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-openvino:latest
    container_name: yunkan
    restart: always
    network_mode: host
    devices:
      - /dev/dri:/dev/dri
    volumes:
      - /mnt/user/appdata/yunkan/data:/app/data
      - /mnt/user/appdata/yunkan/recordings:/app/data/recordings
      - /etc/machine-id:/etc/machine-id:ro
      - /sys/class/dmi/id/product_uuid:/sys/class/dmi/id/product_uuid:ro
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
      - SKYVIEW_SELF_CONTAINER_NAME=yunkan

4. Démarrer SkyView

Option A · CLI (recommandée, fonctionnalités complètes) :

cd /mnt/user/appdata/yunkan
docker compose up -d
docker logs -f yunkan

Option B · Interface graphique : interface web d'Unraid → onglet Docker → bloc « Compose Manager » → « Add New Stack » → nommez-le yunkan → collez le contenu de compose.yml → « Compose Up ».

Une fois démarré, ouvrez http://<Unraid IP>:23406/ dans le navigateur pour accéder à l'assistant de configuration.

5. Ports et pare-feu

Unraid n'a pas de pare-feu par défaut, tous les ports sont donc exposés directement sur l'interface réseau de l'hôte ; SkyView utilise 23406/23880/24214/24215/tcp + 23515/udp.

6. FAQ

Mise à jour : les permissions du socket docker sont normales sur Unraid, la mise à jour en ligne en un clic depuis la console web fonctionne donc directement ; vous pouvez aussi mettre à jour manuellement avec cd /mnt/user/appdata/yunkan && docker compose pull && docker compose up -d.