安裝部署

系統需求

映像檔變體怎麼選

AI 偵測的硬體加速分成 4 個變體，對應不同硬體。裝錯變體只會讓偵測變慢或無法運作，其它功能（錄影、回放、對講）不受影響。一鍵部署腳本會自動偵測硬體幫你選對——下面這張表只是給想手動選擇的人參考。

按硬體選檔（詳細參考）

買新機或評估現有機器時，按 CPU 算力分 5 檔對照下表。給出推薦映像檔、能穩定帶的攝影機數、以及能流暢跑哪些 AI 偵測功能（啟用與否需自己在網頁後台手動開）。

各檔位能流暢跑的偵測功能

檔位越高，能穩定開啟的功能越多。低檔位機器開太多功能，會讓推理跟不上攝影機的影格速率，導致漏掉偵測事件。下表是每個檔位建議開啟的偵測能力——✅ 表示建議開啟、❌ 表示不建議在該硬體上開啟。新安裝預設只開啟物件偵測，其餘都需要在 網頁後台 → 設定 → 偵測 裡依需求手動啟用。

一鍵部署（推薦）

執行一行指令，腳本會自動偵測硬體、選最合適的映像檔變體、拉取映像檔、啟動容器，全程 5–15 分鐘（視網路狀況而定）。

curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash

腳本做了什麼：

• 檢查系統是 Linux x86_64(或 RK3588 板),且已安裝 Docker
• 檢查 23406 / 23880 / 24214 / 23515 等連接埠空閒
• 偵測硬體：NVIDIA 顯示卡（含顯示記憶體）/ Intel 內顯 / Intel NPU
• 自動在 cpu / openvino / cuda / trt 中選出最合適的映像檔變體
• 拉取映像檔（預設從阿里雲）+ 寫入 docker-compose 檔案 + 自動產生高強度隨機金鑰
• 啟動容器並等待健康檢查通過（約 60 秒）
• 輸出瀏覽器存取位址（如 http://192.168.1.10:23406/）

常用參數

# 只看推薦什麼變體，不部署
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash -s -- --detect-only

# 強制用 trt 變體並跳過互動
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash -s -- --variant trt -y

# 離線部署（先把映像檔 tar.gz scp 到機器上）
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh -o install.sh
bash install.sh --offline /path/to/skyview-image.tar.gz

按平台部署（選擇你的裝置）

一鍵腳本對通用 Linux + Docker 環境最方便，但 NAS、HA OS、PVE 等平台都有自己的容器管理介面、網路模式、iGPU 透傳方式和已知的坑。下面針對常見目標平台提供各自的教學，包含每個平台專屬的 compose 檔案、介面部署路徑、防火牆設定和常見問題：

• 群暉 Synology DSM 7.2+ — Container Manager + Intel 內顯機型（DS920+ / DS423+ / DS224+ 等）
• Unraid 6.12+ — Compose Manager + Intel GPU TOP / NVIDIA Driver plugin
• 飛牛 fnOS — Debian 12 base + N100/N305 內建 iGPU
• 綠聯 UGOS Pro — x86 機型（DXP2800/DXP4800/DXP6800 等）
• TrueNAS Scale 24.10+ — Custom App YAML + ZFS dataset 持久化
• Ubuntu / Debian — apt + docker compose v2，最乾淨的部署路徑
• Fedora 39+ — dnf docker-ce + SELinux 磁碟區標籤 + firewalld 放行
• Proxmox VE LXC — privileged LXC + Intel iGPU 透傳（家用 N100 / N305 PVE 使用者首選）
• Home Assistant OS 附加元件 — 加入雲瞰儲存庫一鍵安裝 yunkan / yunkan-openvino addon
• RK3588 板 — 瑞芯微 NPU 加速的低功耗 ARM 小盒子(Orange Pi 5 / Radxa Rock 5 等);推薦 4GB 板,8G+ 實驗性

手動部署（進階）

想自己一步步掌控部署過程的，按下面 4 個步驟走。一鍵腳本本質上就是把這些指令自動化了。

1. 1

   拉取映像檔

   選好上面四個變體之一：

   bash複製

   docker pull registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-cpu:latest

2. 2

   建立資料 / 錄影目錄

   小型狀態（資料庫 / cookies / 日誌）放在 data/；錄影（可達 TB 等級）單獨放在同層級的 recordings/，方便單獨指到大硬碟 / NAS。

   bash複製

   mkdir -p ~/skyview/data ~/skyview/recordings && cd ~/skyview

3. 3

   啟動容器

   用 host 網路讓攝影機直接透過宿主機連接埠，避免 NAT 影響影像品質。授權綁定要求 bind-mount /etc/machine-id 和 product_uuid，不要省略。

   bash複製

   docker run -d --name yunkan --restart=always \
     --network host \
     -v $(pwd)/data:/app/data \
     -v $(pwd)/recordings:/app/data/recordings \
     -v /etc/machine-id:/etc/machine-id:ro \
     -v /sys/class/dmi/id/product_uuid:/sys/class/dmi/id/product_uuid:ro \
     registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-cpu:latest

4. 4

   開啟瀏覽器

   首次造訪會跳到 /setup 精靈，按 首次啟動 一章往下走。

   複製

   http://<伺服器 IP>:23406

連接埠與磁碟區對應

雲瞰 用 host 網路模式運作，所有連接埠都直接綁在宿主機上。正式環境的連接埠都加了一個非常規偏移，落在 2xxxx 區間，避免和你機器上已有的 nginx 80/443、redis 6379、其它服務的 8080/8554/8888 衝突。

環境變數參考

以下環境變數全部可選——host 網路的標準部署一個都不用設，只有橋接網路、反向代理、固定內部金鑰等進階場景才用得到。在 compose 檔案的 environment: 段（或各 NAS 平台的環境變數表單）裡設定。

升級

最方便：網頁後台一鍵升級。 瀏覽器進 網頁後台 → 設定 → 系統 → 檢查更新，發現新版本點 "升級" 即可——系統會自動拉取新映像檔並重建容器（升級前自動備份資料庫，新版本啟動異常會自動回滾到升級前版本），幾分鐘後頁面自動重連到新版本。

想自己在 SSH 裡手動升級也行：

cd ~/skyview
docker compose -f compose.yml pull
docker compose -f compose.yml up -d

或者重跑一鍵腳本（帶 -y 不打擾）：

curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash -s -- -y

解除安裝

cd ~/skyview
docker compose -f compose.yml down
docker rmi registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-cpu:latest
# 錄影 / 資料庫仍會保留，需要徹底清理：
rm -rf ~/skyview