# Déploiement sur Ubuntu / Debian

Un déploiement Linux standard est le plus simple. Sur Ubuntu 22.04 / 24.04 LTS ou Debian 12 (Bookworm), docker + docker compose v2 s'installent en une ligne via apt, et le script en une ligne de SkyView gère la détection de la variante et la configuration de l'accélération GPU.

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

Ubuntu / Debian fonctionne sur pratiquement toutes les machines x86_64, et **les 4 variantes fonctionnent** — choisissez selon votre matériel :

| Matériel | Variante recommandée |
| --- | --- |
| iGPU / NPU Intel 11e génération et plus | openvino |
| GPU NVIDIA + VRAM < 8 Go | cuda |
| GPU NVIDIA + VRAM ≥ 8 Go | trt (plus rapide que cuda) |
| CPU uniquement / CPU AMD sans GPU dédié | cpu |

## 2. Installer docker

Ubuntu comme Debian utilisent le script officiel en une ligne de Docker :

```bash
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Déconnectez-vous et reconnectez-vous pour que le groupe docker prenne effet ; ou temporairement, newgrp docker
```

> **💡 Étape supplémentaire pour les utilisateurs de GPU NVIDIA**
>
> Pour utiliser les variantes cuda/trt, installez d'abord [nvidia-container-toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#installing-with-apt) ; en résumé, `sudo apt install nvidia-container-toolkit && sudo systemctl restart docker`.

## 3. Déployer avec le script en une ligne (recommandé)

Le script en une ligne de SkyView détecte automatiquement le matériel, choisit une variante d'image adaptée, télécharge l'image et démarre le conteneur — le tout en 5 à 15 minutes :

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

À la fin, le script affiche l'URL à ouvrir dans le navigateur (du type `http://192.168.1.10:23406/`) ; ouvrez-la pour accéder à l'[assistant de configuration](/docs/quickstart).

## 4. Ou déployer manuellement avec compose

Si vous préférez contrôler vous-même la configuration — téléchargement dans le navigateur, wget en SSH, ou copier-coller la version minimale ci-dessous ; le modèle Linux générique utilise par défaut la variante openvino, il suffit donc de changer l'image pour la variante correspondant à votre matériel :

[Télécharger le modèle compose générique](/compose/ubuntu-debian.yml)

Modèle docker compose générique · changez le tag d'image en yunkan-cpu / yunkan-openvino / yunkan-cuda / yunkan-trt

Ou via wget en SSH :

```bash
mkdir -p ~/yunkan && cd ~/yunkan
wget https://yun-kan.com/compose/ubuntu-debian.yml -O compose.yml
# Changez image pour la variante correspondant à votre matériel (yunkan-cpu / yunkan-openvino / yunkan-cuda / yunkan-trt)
docker compose up -d
```

Ou copiez la version minimale ci-dessous, enregistrez-la sous `compose.yml`, puis `docker compose up -d` (variante openvino par défaut ; sur une machine sans GPU, changez image en yunkan-cpu et supprimez la section devices) :

```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:
      - ./data:/app/data
      - ./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, à coller et enregistrer)*

## 5. Pare-feu (UFW)

UFW est désactivé par défaut sur Ubuntu. Si vous l'avez activé, autorisez :

```bash
sudo ufw allow 23406,23880,24214,24215/tcp
sudo ufw allow 23515/udp
sudo ufw reload
```

## 6. FAQ

> **ℹ️ AppArmor refuse l'accès à un périphérique (rare)**
>
> AppArmor est actif par défaut sur Ubuntu ; le conteneur SkyView utilise le profil docker-default et n'a normalement aucun souci. Si vous rencontrez tout de même une erreur (très rare), ajoutez `security_opt: ["apparmor=docker-default"]` au compose.

> **ℹ️ Le pilote iGPU de Debian est obsolète**
>
> Le paquet `intel-media-va-driver` du dépôt Bookworm a un support incomplet d'Alder Lake-N (N100/N305). Obtenez une version plus récente avec `apt install -t bookworm-backports intel-media-va-driver-non-free`.

**Mise à jour :** entièrement prise en charge — Web Admin → Paramètres → Système → Vérifier les mises à jour pour une mise à jour en un clic ; ou manuellement, `docker compose pull && docker compose up -d`.

---

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