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 :
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
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 :
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 :
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 -dOu 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) :
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=yunkan5. Pare-feu (UFW)
UFW est désactivé par défaut sur Ubuntu. Si vous l'avez activé, autorisez :
sudo ufw allow 23406,23880,24214,24215/tcp
sudo ufw allow 23515/udp
sudo ufw reload6. FAQ
AppArmor refuse l'accès à un périphérique (rare)
security_opt: ["apparmor=docker-default"] au compose.Le pilote iGPU de Debian est obsolète
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.