# 绿联 UGOS Pro 部署

绿联 UGOS Pro x86 机型(DXP2800 / DXP4800 / DXP6800 / DXP8800 等 N100/N305 系列)走 openvino 变体。⚠️ **绿联部分入门型号是 ARM SoC,云瞰仅提供 amd64 镜像,ARM 机型暂不支持**。

## 1. 适用机型 & 推荐变体

| 机型 | CPU 架构 | 推荐变体 | 可用 |
| --- | --- | --- | --- |
| DXP2800 / DXP4800 / DXP6800 / DXP8800 | Intel x86 + 核显 | openvino | ✅ |
| DXP480T Plus / DXP4800 Plus | Intel x86 + 核显 | openvino | ✅ |
| DX4600 Pro (老款 ARM) | ARM Cortex | — | ❌ 仅 amd64 镜像 |
| 其它 ARM 机型 | ARM | — | ❌ |

> **⚠️ 购买前先查 CPU 架构**
>
> 绿联同型号有时混用 Intel 和 ARM 主板。在 UGOS Pro Web UI → 系统信息 → CPU 一栏,Intel 字样开头才能装云瞰。

## 2. 准备工作

1. **升级 UGOS Pro**

   确保 UGOS Pro 版本含 Container Manager(2024 年后机型出厂自带);老版本 UGOS 用户先升级

2. **建数据目录**

   UGOS 文件管理器 → /volume1/docker/ 下新建 yunkan/;最终路径 /volume1/docker/yunkan/

3. **启用 SSH(可选)**

   控制面板 → 终端 → SSH 启用;不开 SSH 也能用 Web Container Manager 完成部署,但 SSH 命令更直观

## 3. 获取 compose 文件

三种方式任选其一:

[浏览器下载 compose.yml](/compose/ugos.yml)

绿联 UGOS Pro 专用 · openvino 变体 · 含 OTA sidecar

或 SSH 用 wget:

```bash
ssh <用户名>@<绿联IP>
cd /volume1/docker/yunkan
wget https://yun-kan.com/compose/ugos.yml -O compose.yml
```

> **💡 或者 Web UI 粘贴**
>
> UGOS Pro → Container Manager → 自定义项目 → YAML 编辑器粘贴下面最小版。

```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
  updater:
    image: registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-updater:latest
    container_name: yunkan-updater
    restart: always
    network_mode: none
    volumes:
      - /volume1/docker/yunkan/data:/app/data
      - /volume1/docker/yunkan/compose.yml:/app/compose.yml:ro
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
      - COMPOSE_PROJECT_NAME=yunkan
      - STATE_FILE=/app/data/.upgrade-state
      - SKYVIEW_COMPOSE_FILE=/app/compose.yml
      - SKYVIEW_COMPOSE_SERVICE=yunkan
```

*compose.yml (最小版)*

## 4. 启动云瞰

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

启动后浏览器 `http://<绿联IP>:23406/` 进入 [Setup 向导](/docs/quickstart)。

## 5. 端口和防火墙

UGOS Pro Web Panel 占用 80/443/9999,云瞰 23406 系列无冲突。绿联默认 iptables 不严格挡端口,LAN 内可直接访问。

## 6. 常见问题

> **ℹ️ Container Manager 显示容器运行但访问不到**
>
> SSH `ss -tnlp | grep 23406` 看进程是否在监听;如果在则是防火墙问题,放行 23406-24215/tcp + 23515/udp。

> **ℹ️ iGPU 透传不生效**
>
> SSH `vainfo` 看 VAAPI 是否可用;`docker exec yunkan vainfo` 看容器内能否访问 iGPU。无输出请确认机器是 Intel CPU 且 BIOS 开了核显。

**升级**:Container Manager 重新拉镜像即可;或 SSH `docker compose pull && docker compose up -d`。

---

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