# Déploiement sur UGREEN UGOS Pro

Les modèles x86 UGREEN UGOS Pro (DXP2800 / DXP4800 / DXP6800 / DXP8800 et autres séries N100/N305) utilisent la variante openvino. ⚠️ **Certains modèles UGREEN d'entrée de gamme sont des SoC ARM ; SkyView ne fournit que des images amd64, les modèles ARM ne sont donc pas encore pris en charge**.

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

| Modèle | Architecture CPU | Variante recommandée | Disponible |
| --- | --- | --- | --- |
| DXP2800 / DXP4800 / DXP6800 / DXP8800 | Intel x86 + iGPU | openvino | ✅ |
| DXP480T Plus / DXP4800 Plus | Intel x86 + iGPU | openvino | ✅ |
| DX4600 Pro (ancien ARM) | ARM Cortex | — | ❌ images amd64 uniquement |
| Autres modèles ARM | ARM | — | ❌ |

> **⚠️ Vérifiez l'architecture CPU avant l'achat**
>
> UGREEN mélange parfois des cartes Intel et ARM sous un même nom de modèle. Dans l'interface web UGOS Pro → Informations système → CPU, elle doit commencer par « Intel » pour pouvoir installer SkyView.

## 2. Prérequis

1. **Mettre à jour UGOS Pro**

   Assurez-vous que votre version d'UGOS Pro inclut Container Manager (les modèles à partir de 2024 l'incluent) ; les utilisateurs d'UGOS plus anciens doivent d'abord se mettre à jour

2. **Créer le répertoire de données**

   Gestionnaire de fichiers UGOS → créez yunkan/ sous /volume1/docker/ ; le chemin final est /volume1/docker/yunkan/

3. **Activer SSH (facultatif)**

   Panneau de configuration → Terminal → activer SSH ; vous pouvez aussi tout déployer depuis l'interface web Container Manager sans SSH, mais les commandes SSH sont plus directes

## 3. Récupérer le fichier compose

Choisissez l'une des trois méthodes :

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

Modèle UGREEN UGOS Pro · variante openvino · mise à jour en ligne via la console web

Ou via wget en SSH :

```bash
ssh <username>@<UGREEN IP>
cd /volume1/docker/yunkan
wget https://yun-kan.com/compose/ugos.yml -O compose.yml
```

> **💡 Ou coller dans l'interface web**
>
> UGOS Pro → Container Manager → Projet personnalisé → éditeur YAML, et collez la version minimale 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:
      - /volume1/docker/yunkan/data:/app/data
      - /volume1/docker/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. Démarrer SkyView

```bash
cd /volume1/docker/yunkan
docker compose up -d
docker logs -f yunkan
```

Une fois démarré, ouvrez `http://<IP UGREEN>:23406/` dans le navigateur pour accéder à l'[assistant de configuration](/docs/quickstart).

## 5. Ports et pare-feu

Le panneau web UGOS Pro utilise 80/443/9999 ; la famille de ports 23406 de SkyView n'entre pas en conflit. Les iptables par défaut d'UGREEN ne bloquent pas strictement les ports, l'accès en LAN fonctionne donc directement.

## 6. FAQ

> **ℹ️ Container Manager indique que le conteneur tourne mais il est inaccessible**
>
> En SSH, `ss -tnlp | grep 23406` pour vérifier si le processus écoute ; si c'est le cas, il s'agit d'un problème de pare-feu — autorisez 23406-24215/tcp + 23515/udp.

> **ℹ️ Le passthrough iGPU ne fonctionne pas**
>
> Exécutez `vainfo` en SSH pour vérifier si VAAPI est disponible ; `docker exec yunkan vainfo` vérifie l'accès à l'iGPU dans le conteneur. Aucune sortie signifie qu'il faut vérifier que la machine dispose bien d'un CPU Intel et que l'iGPU est activé dans le BIOS.

**Mise à jour :** retéléchargez l'image dans Container Manager ; ou en SSH, `docker compose pull && docker compose up -d`.

---

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