Home Assistant OS アドオンデプロイ

Home Assistant OS または HA Supervised をお使いの方は、アドオン(Add-on)としてワンクリックで SkyView をインストールできます。SkyView は yunkan(CPU 汎用版)と yunkan-openvino(Intel iGPU 加速版)の 2 つのアドオンを提供しています。

1. 適用範囲

amd64 アーキテクチャのみ

SkyView アドオンは現在 amd64 イメージのみを提供しています。Raspberry Pi(armv7/aarch64)/ HA Green / HA Yellow などの ARM ホストは非対応です。Intel NUC / ミニ PC / x86 PC に HA OS を導入している場合のみ利用できます。
アドオン対応ハードウェア推論速度
yunkan任意の amd64 HA OS ホストCPU のみ
yunkan-openvinoIntel CPU + 内蔵 GPU(第 11 世代以降の Iris Xe / N100 / N305)iGPU アクセラレーション、推奨

同時にインストールできるのは 1 つだけ

2 つのアドオンはポートが完全に同じ(23406 / 23880 / 24214 / 23515)なので、同時には有効化できません。Intel 機なら yunkan-openvino、それ以外は yunkan を選んでください。

2. SkyView リポジトリを追加

推奨方法:ワンクリックで移動。 HA にアクセスできる端末で本ページを開き、下のバッジをクリックすると、my.home-assistant.io が自動的にあなたの HA を見つけてリポジトリアドレスを入力済みにしてくれます。あとは確認するだけです。

Home Assistant に追加

初回クリック時は HA のアドレス(例:http://homeassistant.local:8123)の入力を求められますが、以降は記憶されます。ジャンプに失敗した場合や My Home Assistant コンポーネントが未導入の場合は、下記の手動手順を使ってください。

手動での方法:

  1. 1

    アドオンストアを開く

    HA の Web 画面 → 設定(Settings)→ アドオン(Add-ons)→ アドオンストア(Add-on Store)

  2. 2

    カスタムリポジトリを追加

    右上の三点メニュー → リポジトリ(Repositories)→ 下記の URL を貼り付け → 追加(Add)

  3. 3

    この URL を貼り付け

    以下のアドレスをそのままコピー&ペーストしてください:

text
https://github.com/mrtian2016/yunkan-hassio-addons

追加するとページが更新され、アドオンストアの下部に「Yunkan」というセクションが追加されます。そこに yunkan と yunkan-openvino の 2 つのカードがあります。

3. インストールして起動

  1. 1

    バリアントを選ぶ

    Intel 機なら yunkan-openvino を、それ以外は yunkan をクリックします

  2. 2

    インストール

    右下の「インストール(Install)」ボタンをクリックし、ダウンロードが終わるまで待ちます(イメージは約 700MB、初回は数分かかります)

  3. 3

    設定(任意)

    「設定(Configuration)」タブ:デフォルト設定のままで動作します。特別な要件(ポートの変更、タイムゾーンなど)がある場合はここで調整してください

  4. 4

    起動

    「情報(Info)」タブ → 「起動(Start)」ボタン

  5. 5

    自動起動 + Watchdog を有効にする

    下にある 2 つのスイッチをどちらもオンにしてください:「起動時に開始」+「Watchdog」。これにより HA ホストの再起動やアドオンのクラッシュ時に自動的に復帰します

  6. 6

    Web 画面を開く

    サイドバーに「SkyView」という項目が表示されます(または http://<HA ホスト IP>:23406/ にアクセス)。そこから セットアップウィザード に進みます

4. データの永続化

アドオンのデータは自動的に HA の /share/yunkan/ ディレクトリに保存されます(録画、データベース、モデル、115 の cookies もすべてここにあります)。このディレクトリは:

  • HA OS のバックアップに含まれます — Supervisor → Backups でフルバックアップを行うと /share/ も含まれるため、SkyView のデータも一緒にバックアップされます
  • 外部から SMB でアクセス可能 — HA 標準の Samba アドオンが /share/ をマッピングしているため、PC / NAS から録画ファイルを閲覧できます
  • アップグレードしても消えません — アドオンのアップグレードはイメージの入れ替えのみで、/share 内の永続化データはそのまま保持されます

5. アップグレード

YunKan アドオンは HA アドオンの標準更新フローに従います。新バージョンがあると HA が通知します(右下トースト + 設定 → アドオン → 当該アドオン → 上部の黄色いバナー)。「更新」をクリックするだけです。YunKan ウェブコンソールはアドオン環境を自動検出して適切な更新ガイダンスを表示するため、追加の更新コンポーネントは不要です。

6. よくある質問

HA を Raspberry Pi で動かしています。どうすればいいですか?

RPi は ARM アーキテクチャのため、SkyView アドオンは現在対応していません。中古の Intel ミニ PC(N100 / 第 11 世代 NUC など)を購入して HA OS を導入するのが一般的な解決策です。あるいは RPi には HA OS だけを残し、SkyView は別の x86 マシンに単独で導入して、両者を MQTT ブリッジ で連携させる方法もあります。

iGPU アクセラレーションが効かない(yunkan-openvino バリアント)

アドオンの config には既に devices: [/dev/dri:/dev/dri:rwm] が設定されており、理論上は自動的にパススルーされます。失敗する主な原因は、ホストに内蔵 GPU がない(HA Supervisor → Host system → CPU が Intel かどうかを確認)、または HA OS のカーネルがその機種の iGPU に対応していない、のいずれかです。yunkan(CPU)バリアントに戻しても引き続き動作します。

バリアントを切り替える際は上書きインストールしない

yunkan から yunkan-openvino へ切り替えたい場合(逆も同様):まず旧バージョンをアンインストールし(データは /share/yunkan/ に残ります)→ 新しいバージョンをインストール → 起動すると /share 内の旧データがそのまま使われるため、再設定は不要です。両方を同時に有効にするとポートが競合します。

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