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érielVariante recommandée
iGPU / NPU Intel 11e génération et plusopenvino
GPU NVIDIA + VRAM < 8 Gocuda
GPU NVIDIA + VRAM ≥ 8 Gotrt (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 ; 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.

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

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.

Déploiement sur Ubuntu / Debian - Documentation SkyView