Ubuntu / Debian 部署

標準 Linux 部署最乾淨。在 Ubuntu 22.04 / 24.04 LTS 或 Debian 12(Bookworm)上,docker + docker compose v2 都只是 apt 一行指令的事,雲瞰一鍵腳本會處理變體偵測和 GPU 加速設定。

1. 適用機型 & 推薦變體

Ubuntu / Debian 幾乎可以跑在所有 x86_64 機器上,全部 4 種變體都能用,依硬體選擇:

硬體	推薦變體
Intel 11 代以上內顯 / NPU	openvino
NVIDIA GPU + 顯示記憶體 < 8GB	cuda
NVIDIA GPU + 顯示記憶體 ≥ 8GB	trt(比 cuda 更快)
純 CPU / AMD CPU 無獨立顯示卡	cpu

2. 安裝 docker

Ubuntu / Debian 都可以用 Docker 官方一鍵腳本:

bash

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# 登出後重新登入讓 docker 群組生效;或暫時執行 newgrp docker

NVIDIA GPU 使用者需要額外安裝

想用 cuda/trt 變體,先安裝 nvidia-container-toolkit;指令大致是 sudo apt install nvidia-container-toolkit && sudo systemctl restart docker。

3. 用一鍵腳本部署(推薦)

雲瞰一鍵腳本會自動偵測硬體、選擇合適的映像檔變體、拉取映像檔、啟動容器,5-15 分鐘就能完成:

bash

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

腳本完成後會直接給出瀏覽器造訪位址(類似 http://192.168.1.10:23406/),進入 Setup 精靈。

4. 或者手動 compose

想自己控制設定——瀏覽器下載、SSH wget、或複製下面的最小版本手動貼上,三種任選;通用 Linux 範本預設 openvino 變體,只需要把 image 改成對應你硬體的變體即可:

瀏覽器下載通用 compose 範本

通用 docker compose 範本 · 需手動把 image 標籤改成 yunkan-cpu / yunkan-openvino / yunkan-cuda / yunkan-trt

compose.yml

或以 SSH 使用 wget:

bash

mkdir -p ~/yunkan && cd ~/yunkan
wget https://yun-kan.com/compose/ubuntu-debian.yml -O compose.yml
# 把 image 改成符合你硬體的變體(yunkan-cpu / yunkan-openvino / yunkan-cuda / yunkan-trt)
docker compose up -d

或直接複製下面的最小版本內容,存成 compose.yml 後執行 docker compose up -d(預設 openvino 變體,純 CPU 機型把 image 改成 yunkan-cpu 並刪掉 devices 段):

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:
      - ./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
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
      - SKYVIEW_SELF_CONTAINER_NAME=yunkan

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

5. 防火牆(UFW)

Ubuntu 預設 UFW 是關閉的。如果你啟用了 UFW,需要放行:

bash

sudo ufw allow 23406/tcp
sudo ufw allow 23515
sudo ufw allow 23880/tcp
sudo ufw reload

6. 常見問題

AppArmor 拒絕裝置存取(罕見)

Ubuntu 預設開啟 AppArmor,雲瞰容器走 docker-default profile 不會踩到坑。如果真的報錯(幾乎不會發生),在 compose 裡加上 security_opt: ["apparmor=docker-default"]。

Debian 的 iGPU 驅動程式版本較舊

Bookworm 儲存庫裡的 intel-media-va-driver 版本對 Alder Lake-N(N100/N305)支援不完整。建議執行 apt install -t bookworm-backports intel-media-va-driver-non-free 以取得較新版本。

升級:完整支援——網頁後台 → 設定 → 系統 → 檢查更新一鍵升級;或手動執行 docker compose pull && docker compose up -d。

這篇文件有幫助嗎？