Ubuntu / Debian デプロイ

標準的な Linux デプロイが最もシンプルです。Ubuntu 22.04 / 24.04 LTS または Debian 12（Bookworm）では、docker + docker compose v2 のインストールは apt コマンド一行で完了し、SkyView のワンライナースクリプトがバリアントの検出と GPU アクセラレーションの設定を処理します。

1. 対応ハードウェアと推奨バリアント

Ubuntu / Debian はほぼすべての x86_64 マシンで動作し、4 つのバリアントすべてが利用可能です。ハードウェアに応じて選んでください：

ハードウェア	推奨バリアント
Intel 第 11 世代以降の内蔵 GPU / NPU	openvino
NVIDIA GPU + VRAM 8GB 未満	cuda
NVIDIA GPU + VRAM 8GB 以上	trt（cuda よりさらに高速）
CPU のみ / 独立 GPU を持たない 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. ワンライナースクリプトでデプロイ（推奨）

SkyView のワンライナースクリプトはハードウェアを自動検出し、適切なイメージバリアントを選択してイメージを取得し、コンテナを起動します。5〜15 分で完了します：

bash

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

スクリプトが完了するとブラウザ用のアクセスアドレス（http://192.168.1.10:23406/ のような形式）が表示されるので、それを開いてセットアップウィザードに進んでください。

4. または手動で compose

自分で設定を管理したい場合——ブラウザでダウンロード、SSH で wget、または下記の最小版をコピー＆ペースト、の 3 通りから選べます。汎用 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 が有効ですが、SkyView コンテナは docker-default プロファイルを使うため問題は起きません。万一エラーが出た場合（ほぼありません）は、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 で新しいバージョンを取得することをお勧めします。

アップグレード：全機能が利用できます——Web 管理画面 → 設定 → システム → アップデートを確認でワンクリックアップグレードできます。または手動で docker compose pull && docker compose up -d。

このページは役に立ちましたか？