Unraid デプロイ

推奨方法:Apps でのワンクリックインストール(Community Applications)

Unraid の Community Applications(略称 CA、Apps タブ)は、コミュニティが管理するアプリストアです。SkyView は CA の公式ストアに掲載されているため、Unraid ユーザーは Apps で「yunkan」を検索するだけでワンクリックインストールできます。テンプレートリポジトリを追加する必要はなく、体験は Home Assistant アドオンと同等です。compose ファイルを手書きする必要も、SSH で接続する必要もありません。

1. 1

   Community Applications プラグインがインストール済みか確認する

   Unraid 6.10 以降であればほとんどの場合プリインストールされています。Apps タブが表示されていれば問題ありません。ない場合は、Plugins → Install Plugin で https://raw.githubusercontent.com/Squidly271/community.applications/master/plugins/community.applications.plg を貼り付けてインストールしてください。

2. 2

   検索してインストール(3 つから 1 つを選択、ポート競合のため同時インストール不可)

   Apps タブ → 検索ボックスに yunkan と入力 → 3 つのバリアントが表示されます:YunKan(CPU のみ、ハードウェア依存なし)/ YunKan-OpenVINO(Intel iGPU、事前に Intel GPU TOP プラグインが必要)/ YunKan-CUDA(NVIDIA GPU、事前に NVIDIA Driver プラグインが必要)。該当するバリアントの Install をクリックすれば、デフォルトのパラメータのままで構いません。データディレクトリはデフォルトで /mnt/user/appdata/yunkan/data です。

3. 3

   初回起動 → Setup ウィザード

   コンテナが起動したら、Docker タブで yunkan コンテナを見つけて → WebUI をクリック(またはブラウザで直接 http://<Unraid IP>:23406/ を開く)→ Setup ウィザード に入る → SQLite を選択 → 管理者を作成 → カメラを追加します。

または:docker compose 方式(カスタム / 旧 Unraid)

以下は compose を手書きする従来のデプロイ方法で、カスタムポートが必要な場合、または CA プラグインのない Unraid < 6.12 のユーザー向けです。前述の CA によるワンクリックインストールを使った方は、本セクションをスキップして 2. 準備 の GPU プラグインインストールに進むか、5. ポートとファイアウォール / 6. よくある質問 まで読み飛ばして構いません。

1. 対応機種と推奨バリアント

2. 準備

1. 1

   Unraid のバージョンを確認する

   Tools → Update OS でバージョンが 6.12.13 以上であることを確認します(それより古いバージョンでは Docker Compose Manager プラグインが必要です)

2. 2

   GPU プラグインをインストールする

   Apps タブで該当するプラグインを検索します:Intel iGPU なら Intel GPU TOP、NVIDIA なら NVIDIA Driver をインストールしてください。インストール後に再起動を促されます。再起動後、/dev/dri または /dev/nvidia* が現れます。

3. 3

   AppData ディレクトリを作成する

   Unraid では慣例的に /mnt/user/appdata/yunkan/ に配置します。新規作成し、compose ファイルを置くためにこのディレクトリへ cd してください。

3. compose ファイルを取得する

以下の 3 つの方法から 1 つ選んでください——ブラウザで直接ダウンロード、SSH で wget、または Unraid の Compose Manager に最小構成を貼り付ける方法です:

または SSH で Unraid に接続します(あるいは Terminal プラグインを使用):

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

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

4. SkyView を起動する

方法 A · CLI(推奨、全機能に対応):

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 は既定でファイアウォールがなく、すべてのポートがホストの NIC 上でそのまま到達可能です。LAN では 雲瞰 は 23406/tcp(必須)、23515/udp + tcp(ライブ映像)、23880/tcp(RTSP、任意)を使います。24214/tcp は内部用で、外部に開ける必要はありません。

6. よくある質問

アップグレード方法:Unraid では docker ソケットの権限が正常なため、Web 管理画面のワンクリックオンラインアップグレードがそのまま使えます。手動で行う場合は cd /mnt/user/appdata/yunkan && docker compose pull && docker compose up -d を実行してください。