# Déploiement sur fnOS

fnOS repose sur Debian 12 avec docker en citoyen de première classe. Cette page couvre deux méthodes d'installation : l'installation en un clic par téléversement du fpk dans l'App Center (la plus simple), ou le déploiement manuel via docker compose (les modèles Intel comme le N100 / N305 / N355 peuvent utiliser l'accélération iGPU).

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

| Modèle | CPU | Variante recommandée |
| --- | --- | --- |
| Modèle phare officiel fnOS | Intel N100 / N305 / N355 | openvino |
| Assemblage maison | i3-i5 11e/12e/13e génération + Iris Xe | openvino |
| Assemblage maison | NVIDIA GTX/RTX | cuda ou trt (VRAM ≥ 8 Go) |
| CPU uniquement | Pas d'iGPU | cpu |

## 2. Quelle méthode choisir

| Méthode | Point d'entrée | Idéal pour | Accélération iGPU / GPU |
| --- | --- | --- | --- |
| Installation en un clic (fpk) | App Center → Installation locale → téléverser le fpk | Utilisateurs particuliers · zéro complication | Pas encore (inférence sur CPU) |
| docker compose | docker → Projet personnalisé → téléverser le compose | Vous voulez l'accélération iGPU / GPU · besoin de configuration flexible | Oui (passthrough /dev/dri) |

> **💡 Comment choisir**
>
> Si vous voulez zéro complication et qu'un N100 / N305 suffit sur CPU, optez pour l'**installation en un clic (fpk)**. Si vous voulez que l'iGPU / le GPU accélère réellement l'inférence, ou que vous avez besoin de personnaliser le compose, utilisez la méthode **docker compose** ci-dessous. En raison du fonctionnement des paquets d'applications fnOS, le modèle compose du fpk est statique et ne peut pas injecter le passthrough du périphérique `/dev/dri` ; l'accélération iGPU n'est donc disponible que via docker compose.

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

[Télécharger le paquet fnOS yunkan-latest.fpk](https://cdn.yun-kan.com/yunkan-latest.fpk)

Paquet App Center fnOS · téléverser et installer · l'image est récupérée en ligne pendant l'installation

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. **Ouvrir App Center → Installation locale**

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

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. **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. **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. **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](/docs/quickstart) et créer le compte administrateur.

> **ℹ️ Où se trouvent les données**
>
> Le fpk crée automatiquement deux dossiers partagés fnOS : `yunkan-data` (base de données / configuration / journaux) et `yunkan-recordings` (enregistrements). Les deux sont visibles dans le gestionnaire de fichiers fnOS et via SMB ; le dossier des enregistrements peut être déplacé vers un volume plus grand dans les paramètres système fnOS sans toucher au dossier d'état.

> **⚠️ Deux limites de la méthode fpk**
>
> (1) L'iGPU `/dev/dri` n'est pas monté, donc l'inférence tourne sur CPU (la variante openvino se rabat sur le chemin CPU) ; (2) les variantes NVIDIA cuda / trt ne sont pas prises en charge. Pour l'accélération iGPU / GPU, utilisez la méthode **docker compose** ci-dessous.

## 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. **Vérifier que docker est installé**

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

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 :

[Télécharger compose.yml](/compose/fnos.yml)

Modèle fnOS · variante openvino · mise à jour en ligne via la console web

Ou via wget en SSH :

```bash
ssh <username>@<fnOS IP>
cd /vol1/1000/yunkan
wget https://yun-kan.com/compose/fnos.yml -O compose.yml
```

> **💡 Ou coller la version minimale**
>
> Vous pouvez aussi utiliser l'interface web fnOS → docker → Projet personnalisé → éditeur YAML et coller l'extrait ci-dessous.

```yaml
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
```

*compose.yml (minimal)*

### 4.3 Démarrer SkyView

**Option A · SSH** :

```bash
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](/docs/quickstart).

## 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

> **ℹ️ L'iGPU ne fonctionne pas**
>
> En SSH sur fnOS, `ls /dev/dri/` doit afficher card0 + renderD128. Si ce n'est pas le cas, vérifiez `dmesg | grep i915` pour voir si le pilote s'est chargé ; certains BIOS désactivent l'iGPU, entrez dans le BIOS et activez Internal Graphics. Remarque : l'installation en un clic fpk ne transmet pas l'iGPU — utilisez la méthode docker compose pour l'accélération iGPU.

**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`.

---

来源:https://yun-kan.com/fr/docs/install-fnos