Déploiement sur fnOS

1. Modèles pris en charge et variante recommandée

2. Quelle méthode choisir

3. Méthode 1 : installation en un clic via l'App Center (fpk · recommandé)

1. 1

   Télécharger le fpk

   Cliquez sur le bouton ci-dessus pour télécharger yunkan-latest.fpk sur votre ordinateur (ou téléchargez-le directement sur le NAS via le navigateur intégré de fnOS).

2. 2

   Ouvrir App Center → Installation locale

   Bureau fnOS → App Center → Installation locale en haut à droite (certaines versions l'appellent « Installation manuelle »).

3. 3

   Téléverser le fpk pour l'installer

   Sélectionnez le yunkan-latest.fpk que vous venez de télécharger et confirmez le téléversement ; fnOS commence à analyser le paquet.

4. 4

   Renseigner l'assistant d'installation

   L'assistant collecte 3 champs : variante (cpu / openvino, openvino par défaut), version de l'image (latest par défaut), et hôte public (uniquement pour les déploiements publics via reverse proxy — laissez vide en LAN).

5. 5

   Attendre le déploiement automatique

   fnOS exécute automatiquement docker pull + crée les dossiers de données partagés + docker compose up. Une fois terminé, une icône SkyView apparaît sur le bureau. Le premier téléchargement de l'image prend quelques minutes selon votre connexion.

6. 6

   Accéder à l'assistant de configuration

   Cliquez sur l'icône SkyView, ou ouvrez http://<IP fnOS>:23406/ dans un navigateur, pour suivre l'assistant de configuration et créer le compte administrateur.

4. Méthode 2 : déploiement manuel via docker compose (accélération iGPU disponible)

Cette méthode utilise « docker → Projet personnalisé » de fnOS avec /dev/dri transmis directement dans le fichier compose, ce qui permet aux modèles Intel comme le N100 / N305 d'utiliser réellement l'iGPU pour l'inférence ; elle facilite aussi les changements de configuration futurs.

4.1 Prérequis

1. 1

   Vérifier que docker est installé

   Console fnOS → App Center → docker (préinstallé) ; ou docker --version en SSH doit afficher un résultat

2. 2

   Créer le répertoire de données

   Gestionnaire de fichiers fnOS → créez yunkan/ sous /vol1/1000/, ou mkdir -p /vol1/1000/yunkan en SSH (/vol1/1000/ est le chemin conventionnel des données utilisateur de fnOS)

4.2 Récupérer le fichier compose

Choisissez l'une des trois méthodes :

Ou via wget en SSH :

ssh <username>@<fnOS IP>
cd /vol1/1000/yunkan
wget https://yun-kan.com/compose/fnos.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:
      - /vol1/1000/yunkan/data:/app/data
      - /vol1/1000/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.3 Démarrer SkyView

Option A · SSH :

cd /vol1/1000/yunkan
docker compose up -d
docker logs -f yunkan

Option B · Interface web : console fnOS → docker → Projets → Nouveau → téléverser compose.yml → démarrer.

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

5. Ports et pare-feu

fnOS utilise le port 8088 par défaut pour son propre panneau web ; la famille de ports 23406 de SkyView n'entre pas en conflit. fnOS ne bloque pas les ports par défaut, l'accès en LAN fonctionne donc directement. Si vous l'exposez publiquement, passez toujours par un reverse proxy + HTTPS.

6. FAQ

Mise à jour : pour les installations fpk, mettez à jour directement via l'App Center de fnOS (ou réinstallez avec une nouvelle version d'image dans l'assistant) ; pour les installations docker compose, mettez à jour en un clic depuis la console web, ou manuellement avec docker compose pull && docker compose up -d.