群暉 Synology DSM 部署

群暉 Intel + 內顯機型(DS920+ / DS423+ / DS1522+ / DS224+ 等)走 openvino 變體效果最好。本頁一步步帶你從 SSH 安裝好到瀏覽器 Setup。AMD/ARM 機型(DS223j / DS723+)沒有 /dev/dri,只能跑 cpu 變體,推理速度降一級但功能不變。

1. 適用機型 & 推薦變體

機型	CPU	推薦變體	備註
DS920+ / DS1522+ / DS923+	Intel J4125 / R1600	openvino	Intel 內顯 + 4-8 路 1080p 可用
DS423+ / DS224+	Intel N100 / N5105	openvino	Alder Lake-N 內顯,2-4 路
DS1621+ / DS1821+ (Ryzen)	AMD V1500B	cpu	無內顯,推理較慢
DS223j / DS723+ (ARM)	Realtek / AMD R1600	不支援	ARM 機型雲瞰僅支援 amd64;Ryzen 無 iGPU

2. 準備工作

1
確認 DSM 版本
控制面板 → 資訊中心 → DSM 版本 ≥ 7.2;低於此版本請先升級
2
安裝 Container Manager
在套件中心搜尋「Container Manager」並安裝(舊版本叫 Docker,7.2 起改名)
3
建立專案目錄
File Station → /docker → 新建資料夾 yunkan;最終路徑形如 /volume1/docker/yunkan/
4
啟用 SSH
控制面板 → 終端機和 SNMP → 啟用 SSH;後面會用 SSH 執行 docker compose(Container Manager GUI 不支援 devices 欄位)

3. 取得 compose 檔案

三種方式任選其一——瀏覽器直接下載、SSH 用 wget、或複製最小版本手動貼上:

瀏覽器下載 compose.yml

群暉 DSM 7.2+ 專用範本 · openvino 變體 · 含完整註解

compose.yml

或直接在群暉的 SSH 裡使用 wget:

bash

ssh admin@<群暉IP>
sudo -i
cd /volume1/docker/yunkan
wget https://yun-kan.com/compose/synology.yml -O compose.yml

或者一鍵複製貼上(最小版本)

不想用 wget 也可以複製下面的最小版 compose,執行 vi compose.yml 貼上並儲存。一樣能跑,只是少了詳細註解。

yaml

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:
      - ./data:/app/data
      - ./recordings:/app/data/recordings
      - /etc/machine-id:/etc/machine-id:ro
      - /sys/class/dmi/id/product_uuid:/sys/class/dmi/id/product_uuid:ro
    environment:
      - TZ=Asia/Shanghai
      - SKYVIEW_SELF_CONTAINER_NAME=yunkan

compose.yml(最小版,貼上並儲存)

4. 啟動雲瞰

bash

cd /volume1/docker/yunkan
docker compose up -d
# 查看啟動日誌(Ctrl-C 離開):
docker logs -f yunkan

等約 30-60 秒各服務就緒,瀏覽器打開 http://<群暉IP>:23406/ 進入 Setup 精靈。

5. 連接埠和防火牆放行

群暉預設 80/443/5000/5001 是 DSM 自己的網頁,雲瞰用 23406 系列(偏移到 2xxxx 區間)避免衝突。如果你開啟了 控制面板 → 安全性 → 防火牆,需要放行這 5 個連接埠:

23406/tcp — 雲瞰網頁 + API + 直播(必須)
23515/udp + tcp — 即時畫面低延遲通道(不開會自動降級到 HLS,延遲約 2.5 秒)
23880/tcp — RTSP 直連輸出(VLC / 第三方 NVR 用,可選)
24214/tcp — 內部串流服務,區域網路存取不需要開放

6. 常見問題

Container Manager GUI 無法設定 iGPU 透傳

Container Manager 的「映像 → 啟動 → 裝置」沒有新增 /dev/dri 的入口。必須用 compose 檔案(本頁教學)或用 SSH 執行 docker run --device /dev/dri:/dev/dri ...。

DS920+ / N100 機型 OpenVINO iGPU 失敗回退

部分群暉核心對 Alder Lake-N 的 i915 驅動程式支援不完整,OpenVINO GPU plugin 可能初始化失敗 → 自動回退到 CPU 推理。偵測啟動日誌裡出現 "GPU plugin failed, falling back to CPU" 就是這種情況,功能不受影響只是慢一點。

License 啟用報 SLOTS_FULL

部分機型 DMI 裡的 product_uuid 沒有填值,容器讀到的是空值。雲瞰會回退到只用 /etc/machine-id 計算指紋,通常沒問題;若啟用仍然失敗,請把錯誤碼截圖寄到 support@yun-kan.com 處理。

升級方式:DSM Container Manager 限制 docker socket 存取,網頁後台一鍵線上升級在群暉上不可用(增量修補不受影響)。手動升級:docker compose pull && docker compose up -d --force-recreate yunkan。

這篇文件有幫助嗎？