インストール

システム要件

イメージバリアントの選び方

AI 検出のハードウェアアクセラレーションは 4 つのバリアントに分かれており、それぞれ異なるハードウェアに対応します。バリアントを間違えても検出が遅くなる、または動作しなくなるだけで、他の機能（録画、再生、双方向通話）には影響しません。ワンライナー導入スクリプトが自動的にハードウェアを検出して適切なものを選んでくれます——下の表は手動で選びたい人向けの参考です。

ハードウェア別グレードの選び方（詳細リファレンス）

新しいマシンを購入する、または既存のマシンを評価する際は、CPU の性能に応じた下の 5 段階のグレードを参考にしてください。それぞれ推奨イメージ、安定して扱えるカメラ台数、快適に動作させられる AI 検出機能（有効化するかどうかは Web 管理画面で手動設定が必要）を示しています。

各グレードで快適に動作する検出機能

グレードが高いほど、安定して有効化できる機能が増えます。低いグレードのマシンで機能を開きすぎると、推論がカメラのフレームレートに追いつかず、イベントを見逃す原因になります。下の表は各グレードで有効化を推奨する検出能力を示しています——✅ は有効化推奨、❌ はそのハードウェアでは非推奨を意味します。新規インストール時はデフォルトで物体検出のみが有効になっており、それ以外は Web 管理画面 → 設定 → 検出 で必要に応じて手動で有効化してください。

ワンライン導入（推奨）

1 行のコマンドを実行するだけで、スクリプトが自動的にハードウェアを検出し、最適なイメージバリアントを選んで、イメージを取得し、コンテナを起動します。所要時間は全体で 5–15 分程度です（ネットワーク状況による）。

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

スクリプトが行うこと：

• システムが Linux x86_64(または RK3588 ボード)で、Docker がインストール済みであることを確認
• 23406 / 23880 / 24214 / 23515 などのポートが空いているか確認
• ハードウェアを検出：NVIDIA GPU（VRAM 容量を含む）/ Intel 内蔵 GPU / Intel NPU
• cpu / openvino / cuda / trt の中から最適なイメージバリアントを自動選択
• イメージを取得（デフォルトでは Aliyun から）+ docker-compose ファイルを作成 + 強力なランダムシークレットを自動生成
• コンテナを起動し、ヘルスチェックが通るまで待機（約 60 秒）
• ブラウザでアクセスする URL を出力（例：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 などのプラットフォームにはそれぞれ独自のコンテナ管理 UI、ネットワークモード、iGPU パススルー方式、既知の落とし穴があります。以下によく使われる対象プラットフォームごとの専用チュートリアルを用意しました。各プラットフォーム固有の compose ファイル、UI 上のデプロイ手順、ファイアウォール設定、よくある質問を含みます：

• Synology DSM 7.2+ — Container Manager + Intel 内蔵 GPU 搭載機種（DS920+ / DS423+ / DS224+ など）
• Unraid 6.12+ — Compose Manager + Intel GPU TOP / NVIDIA Driver plugin
• fnOS — Debian 12 ベース + N100/N305 内蔵 iGPU
• UGREEN UGOS Pro — x86 機種（DXP2800/DXP4800/DXP6800 など）
• TrueNAS Scale 24.10+ — Custom App YAML + ZFS データセットによる永続化
• 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 アドオン — SkyView リポジトリを追加してワンクリックで yunkan / yunkan-openvino アドオンをインストール
• RK3588 ボード — Rockchip NPU アクセラレーションによる低消費電力の ARM 小型ボックス(Orange Pi 5 / Radxa Rock 5 など);4GB ボード推奨、8G 以上は実験的

手動デプロイ（上級者向け）

デプロイの過程を自分で一歩ずつコントロールしたい場合は、以下の 4 ステップに従ってください。ワンライナースクリプトは、本質的にこれらのコマンドを自動化したものです。

1. 1

   イメージを取得

   上記 4 つのバリアントのいずれかを選びます：

   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 による映像品質への影響を避けられます。ライセンスのバインドには /etc/machine-id と product_uuid の bind-mount が必要です。省略しないでください。

   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

ポートとボリュームのマッピング

SkyView は 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