飛牛 fnOS 部署

飛牛 fnOS 基於 Debian 12,docker 一等公民。本頁提供兩種安裝方式:應用中心上傳 fpk 一鍵安裝(最省事),或 docker compose 手動部署(N100 / N305 / N355 等 Intel 機型可走內顯加速)。

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. 選哪種安裝方式

安裝方式	入口	適合人群	內顯 / 獨顯加速
fpk 一鍵安裝	應用中心 → 本地安裝 → 上傳 fpk	一般家庭使用者 · 不想折騰	暫不支援(推理走 CPU)
docker compose	docker → 自訂專案 → 上傳 compose	想用內顯 / 獨顯加速 · 需靈活改設定	支援(/dev/dri 透傳)

怎麼選

圖省事、N100 / N305 用 CPU 跑得動就選 fpk 一鍵安裝;想讓內顯 / 獨顯真正參與推理加速,或需要自訂 compose,就用下面的 docker compose 方式。受飛牛應用包機制限制,fpk 的 compose 範本是靜態的,無法注入 /dev/dri 裝置透傳,所以內顯加速只能走 docker compose。

3. 方式一:應用中心一鍵安裝(fpk · 推薦)

下載飛牛應用包 yunkan-latest.fpk

飛牛應用中心安裝包 · 上傳即裝 · 映像檔在安裝時自動線上拉取

yunkan-latest.fpk

1
下載 fpk
點上方按鈕把 yunkan-latest.fpk 下載到電腦(也可直接在飛牛內建瀏覽器裡下載到 NAS)。
2
打開應用中心 → 本地安裝
飛牛桌面 → 應用中心 → 右上角 本地安裝(部分版本叫「手動安裝」)。
3
上傳 fpk 安裝
選擇剛下載的 yunkan-latest.fpk,確認上傳,飛牛開始解析安裝包。
4
填寫安裝精靈
彈出精靈收集 3 個欄位:變體(cpu / openvino,預設 openvino)、映像檔版本(預設 latest)、公網網域(只有走反代公網部署才填,區域網路直接留空)。
5
等待自動部署
飛牛自動 docker pull 映像檔 + 建資料共用目錄 + docker compose up,完成後桌面出現雲瞰圖示。首次拉映像檔視網路耗時幾分鐘。
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
確認 docker 已安裝
fnOS 控制台 → 應用中心 → docker(出廠預裝);或 SSH docker --version 應有輸出
2
建立資料目錄
fnOS 檔案管理 → /vol1/1000/ 下新建 yunkan/,或 SSH mkdir -p /vol1/1000/yunkan(/vol1/1000/ 是飛牛的使用者資料慣用路徑)

4.2 取得 compose 檔案

三種方式任選其一:

瀏覽器下載 compose.yml

飛牛 fnOS 專用 · openvino 變體 · 支援網頁後台線上升級

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

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 預設不擋連接埠,區域網路內直接存取即可。若公網暴露務必走反代 + 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。

這篇文件有幫助嗎？