# 飞牛 fnOS 部署

飞牛 fnOS 基于 Debian 12,docker 一等公民,N100 / N305 / N355 等 Intel 机型出厂带核显走 openvino 变体效果最好。本页带你从 fnOS Web 面板和 SSH 两种方式启动。

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

| 机型 | CPU | 推荐变体 |
| --- | --- | --- |
| 飞牛官方主推机 | Intel N100 / N305 / N355 | openvino |
| DIY 机 | 11/12/13 代 i3-i5 + Iris Xe | openvino |
| DIY 机 | NVIDIA GTX/RTX | cuda 或 trt(显存 ≥ 8GB) |
| 纯 CPU | 无核显 | cpu |

## 2. 准备工作

1. **确认 docker 已装**

   fnOS 控制台 → 应用中心 → docker(出厂预装);或 SSH `docker --version` 应有输出

2. **建数据目录**

   fnOS 文件管理 → /vol1/1000/ 下新建 yunkan/,或 SSH `mkdir -p /vol1/1000/yunkan`(/vol1/1000/ 是飞牛的用户数据习惯路径)

## 3. 获取 compose 文件

三种方式任选其一:

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

飞牛 fnOS 专用 · openvino 变体 · 含 OTA sidecar

或 SSH 用 wget:

```bash
ssh <用户名>@<飞牛IP>
cd /vol1/1000/yunkan
wget https://yun-kan.com/compose/fnos.yml -O compose.yml
```

> **💡 或者粘贴最小版**
>
> 也可直接用 fnOS Web UI → docker → 自定义项目 → 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:
      - /vol1/1000/yunkan/data:/app/data
      - /vol1/1000/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:
      - /vol1/1000/yunkan/data:/app/data
      - /vol1/1000/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. 启动云瞰

**方式 A · SSH**:

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

**方式 B · Web UI**:fnOS 控制台 → docker → 项目 → 新建 → 上传 compose.yml → 启动。

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

## 5. 端口和防火墙

飞牛默认 8088 是自身 Web 面板,云瞰 23406 系列无冲突。fnOS 默认不挡端口,LAN 内直接访问即可。若公网暴露务必走反代 + HTTPS。

## 6. 常见问题

> **ℹ️ iGPU 不工作**
>
> 飞牛 SSH `ls /dev/dri/` 应有 card0 + renderD128。没有的话查 `dmesg | grep i915` 看驱动是否正常加载;部分客户机型 BIOS 关了 iGPU,进 BIOS 打开 Internal Graphics。

**升级**:OTA sidecar 在飞牛上 docker socket 权限正常可用;也可手动 `docker compose pull && docker compose up -d`。

---

来源:https://yun-kan.com/zh-CN/docs/install-fnos