飞牛 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

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

compose.yml

或 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 向导。

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。