Unraid 部署

Unraid 使用者優先走 Community Applications 一鍵裝(Apps 搜尋 'yunkan' 即可,體驗對齊 HA 附加元件);需要自訂連接埠 / 舊版 Unraid 走下方 docker compose 路徑。兩條路徑都涵蓋 Intel iGPU + NVIDIA GPU。

推薦路徑:Apps 一鍵安裝(Community Applications)

Unraid 的 Community Applications(簡稱 CA,Apps 標籤頁)是社群維護的應用程式商店。雲瞰已上架 CA 官方商店,Unraid 使用者直接在 Apps 裡搜尋 'yunkan' 就能一鍵裝,無需新增任何範本儲存庫,體驗對齊 Home Assistant 附加元件。無需手寫 compose,無需 SSH。

什麼時候用 CA,什麼時候用 compose

絕大多數 Unraid 使用者走 CA 即可:雲瞰單容器把所有處理程序合在一起,CA 裝出來就能跑,網頁後台的一鍵線上升級同樣開箱可用(範本已掛載 docker socket)。走下方 docker compose 路徑只有兩種情況:(1) 需要自訂連接埠(映像檔 hardcode,不能在容器面板改);(2) Unraid 版本 < 6.12 / 沒裝 CA 外掛。

1
確認已裝 Community Applications 外掛
Unraid 6.10+ 大多預裝。Apps 標籤頁可見即 OK。如缺少,Plugins → Install Plugin 貼上 https://raw.githubusercontent.com/Squidly271/community.applications/master/plugins/community.applications.plg 安裝。
2
搜尋並安裝(三選一,連接埠衝突不可同時裝)
Apps 標籤頁 → 搜尋框輸入 yunkan → 出現 3 個變體:YunKan(純 CPU,無硬體依賴)/ YunKan-OpenVINO(Intel iGPU,需先裝 Intel GPU TOP plugin)/ YunKan-CUDA(NVIDIA GPU,需先裝 NVIDIA Driver plugin)。點對應變體的 Install,預設參數即可,資料目錄預設 /mnt/user/appdata/yunkan/data。
3
首次啟動 → Setup 精靈
容器啟動後,Docker 標籤頁找到 yunkan 容器 → 點 WebUI(或瀏覽器直接 http://<Unraid IP>:23406/)→ 進入 Setup 精靈 → 選 SQLite → 建管理員 → 加攝影機。

GPU plugin 依賴 & 連接埠 / FAQ

OpenVINO 變體需先裝 Intel GPU TOP plugin,CUDA 變體需先裝 NVIDIA Driver plugin —— 詳細步驟見下方 2. 準備工作。連接埠佔用 / 公網暴露警告 / iGPU 透傳 FAQ 在下方 compose 路徑章節,CA 路徑同樣適用。

OTA 升級

走 CA 路徑時,Apps 標籤頁發現新版會標紅點,點 Update 即可拉新映像檔並重建容器;也可以直接在雲瞰網頁後台 → 設定 → 系統升級一鍵升級(升級失敗自動回滾)。兩種方式效果一致,任選其一。

或:docker compose 路徑(自訂 / 舊 Unraid)

下面是手寫 compose 的傳統部署路徑,適用於需要自訂連接埠、或 Unraid < 6.12 沒 CA 外掛的使用者。前面 CA 一鍵裝的使用者可以跳過本節,直接看 2. 準備工作裡 GPU plugin 安裝,或者翻到 5. 連接埠和防火牆 / 6. 常見問題。

1. 適用機型 & 推薦變體

硬體	推薦變體	需要的 plugin
Intel CPU + 內顯(11 代+)	openvino	Intel GPU TOP
NVIDIA GPU(GTX 1060+ / 顯示記憶體 ≥ 4GB)	cuda	NVIDIA Driver
NVIDIA GPU + 顯示記憶體 ≥ 8GB(2060+ / 3060+)	trt	NVIDIA Driver
純 CPU(無內顯 / 無獨顯)	cpu	無

2. 準備工作

1
確認 Unraid 版本
Tools → Update OS 看版本 ≥ 6.12.13(更舊版本需要裝 Docker Compose Manager plugin)
2
裝 GPU plugin
Apps 標籤頁搜尋對應 plugin:Intel iGPU 裝 Intel GPU TOP,NVIDIA 裝 NVIDIA Driver;裝完會提示重新開機,重新開機後 /dev/dri 或 /dev/nvidia* 出現
3
建 AppData 目錄
Unraid 習慣放在 /mnt/user/appdata/yunkan/,新建即可;cd 到該目錄準備放 compose 檔案

3. 取得 compose 檔案

三種方式任選其一——瀏覽器直接下載、SSH 用 wget、或在 Unraid Compose Manager 裡貼上最小版本:

瀏覽器下載 compose.yml

Unraid 6.12+ 專用 · openvino 變體 · 支援網頁後台線上升級

compose.yml

或 SSH 進 Unraid(或用 Terminal 外掛):

bash

ssh root@<Unraid IP>
mkdir -p /mnt/user/appdata/yunkan
cd /mnt/user/appdata/yunkan
wget https://yun-kan.com/compose/unraid.yml -O compose.yml

Intel iGPU 還是 NVIDIA GPU

預設 compose 檔案用 openvino 變體(Intel iGPU)。NVIDIA 使用者:把 image: 改成 yunkan-cuda 或 yunkan-trt,並取消檔案裡 deploy.resources 的註解。

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:
      - /mnt/user/appdata/yunkan/data:/app/data
      - /mnt/user/appdata/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. 啟動雲瞰

方式 A · CLI(推薦,功能完整):

bash

cd /mnt/user/appdata/yunkan
docker compose up -d
docker logs -f yunkan

方式 B · GUI:Unraid Web UI → Docker 標籤頁 → "Compose Manager" 區塊 → "Add New Stack" → 命名為 yunkan → 把 compose.yml 內容貼進去 → "Compose Up"。

啟動後瀏覽器開啟 http://<Unraid IP>:23406/ 進入 Setup 精靈。

5. 連接埠和防火牆

Unraid 預設無防火牆,所有連接埠直接暴露在主機網卡上。雲瞰區域網路用到 23406/tcp(必須)、23515/udp + tcp(即時畫面)、23880/tcp(RTSP,可選);24214/tcp 是內部服務,不需要對外開放。

不要公網暴露

Unraid 預設監聽 0.0.0.0 + 無防火牆 = 任何上行公網的裝置都能直接掃到你的攝影機。務必走 Tailscale / Wireguard / Cloudflare Tunnel + HTTPS。詳見用戶端 → 遠端存取。

6. 常見問題

iGPU 透傳不生效 / OpenVINO 顯示找不到 GPU

確認 Intel GPU TOP plugin 裝完已重新開機,SSH 跑 ls -la /dev/dri/ 應該看到 card0 / renderD128。否則就是裝錯 plugin 或機器沒有內顯(查 lspci | grep -i vga)。

NVIDIA GPU 透傳不生效

SSH 跑 nvidia-smi(NVIDIA Driver plugin 裝好後可用),能看到顯示卡代表 host 端正常;若 compose 啟動後容器內 docker exec yunkan nvidia-smi 失敗,確認 image 是 yunkan-cuda 而不是 yunkan-openvino。

升級方式:Unraid 上 docker socket 權限正常,網頁後台一鍵線上升級開箱即用;也可以手動執行 cd /mnt/user/appdata/yunkan && docker compose pull && docker compose up -d。

這篇文件有幫助嗎？