云瞰
立即购买

飞牛 fnOS 部署

飞牛 fnOS 基于 Debian 12,docker 一等公民。本页提供两种安装方式:应用中心上传 fpk 一键安装(最省事),或 docker compose 手动部署(N100 / N305 / N355 等 Intel 机型可走核显加速)。

1. 适用机型 & 推荐变体

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

2. 选哪种安装方式

安装方式入口适合人群核显 / 独显加速
fpk 一键安装应用中心 → 本地安装 → 上传 fpk普通家庭用户 · 不想折腾暂不支持(推理走 CPU)
docker composedocker → 自定义项目 → 上传 compose想用核显 / 独显加速 · 需灵活改配置支持(/dev/dri 透传)

怎么选

图省事、N100 / N305 用 CPU 跑得动就选 fpk 一键安装;想让核显 / 独显真正参与推理加速,或需要自定义 compose,就用下面的 docker compose 方式。受飞牛应用包机制限制,fpk 的 compose 模板是静态的,无法注入 /dev/dri 设备透传,所以核显加速只能走 docker compose。

3. 方式一:应用中心一键安装(fpk · 推荐)

下载飞牛应用包 yunkan-latest.fpk

飞牛应用中心安装包 · 上传即装 · 镜像在安装时自动在线拉取

  1. 1

    下载 fpk

    点上方按钮把 yunkan-latest.fpk 下载到电脑(也可直接在飞牛自带浏览器里下到 NAS)。

  2. 2

    打开应用中心 → 本地安装

    飞牛桌面 → 应用中心 → 右上角 本地安装(部分版本叫「手动安装」)。

  3. 3

    上传 fpk 安装

    选择刚下载的 yunkan-latest.fpk,确认上传,飞牛开始解析安装包。

  4. 4

    填写安装向导

    弹出向导收集 3 个字段:变体(cpu / openvino,默认 openvino)、镜像版本(默认 latest)、公网域名(只有走反代公网部署才填,内网直接留空)。

  5. 5

    等待自动部署

    飞牛自动 docker pull 镜像 + 建数据共享目录 + docker compose up,完成后桌面出现云瞰图标。首次拉镜像视网络耗时几分钟。

  6. 6

    进入 Setup 向导

    点云瞰图标,或浏览器打开 http://<飞牛IP>:23406/ 走 Setup 向导 建管理员账号。

数据放哪

fpk 自动建两个飞牛共享文件夹:yunkan-data(数据库 / 配置 / 日志)和 yunkan-recordings(录像)。两者在飞牛文件管理和 SMB 都可见;录像盘可在飞牛系统设置里单独移到大容量卷,不动状态盘。

fpk 方式的两点限制

① 不挂载核显 /dev/dri,推理走 CPU(openvino 变体会 fallback CPU 路径);② 不支持 NVIDIA cuda / trt 变体。需要核显 / 独显加速,请改用下面的 docker compose 方式。

4. 方式二:docker compose 手动部署(可走核显加速)

走飞牛「docker → 自定义项目」,compose 里直接 /dev/dri 透传,N100 / N305 等 Intel 机型让核显真正参与推理;后续也方便灵活改配置。

4.1 准备工作

  1. 1

    确认 docker 已装

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

  2. 2

    建数据目录

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

4.2 获取 compose 文件

三种方式任选其一:

浏览器下载 compose.yml

飞牛 fnOS 专用 · openvino 变体 · 支持网页后台在线升级

或 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
compose.yml (最小版)

4.3 启动云瞰

方式 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。注意:fpk 一键安装不透传核显,核显加速请走 docker compose 方式。

升级:fpk 安装的走飞牛应用中心直接升级(或在向导里改镜像版本重装);docker compose 安装的在网页后台一键在线升级,也可手动 docker compose pull && docker compose up -d。

飞牛 fnOS 部署 - 云瞰 文档