Home Assistant OS アドオンデプロイ
Home Assistant OS または HA Supervised をお使いの方は、アドオン(Add-on)としてワンクリックで SkyView をインストールできます。SkyView は yunkan(CPU 汎用版)と yunkan-openvino(Intel iGPU 加速版)の 2 つのアドオンを提供しています。
1. 適用範囲
amd64 アーキテクチャのみ
| アドオン | 対応ハードウェア | 推論速度 |
|---|---|---|
| yunkan | 任意の amd64 HA OS ホスト | CPU のみ |
| yunkan-openvino | Intel CPU + 内蔵 GPU(第 11 世代以降の Iris Xe / N100 / N305) | iGPU アクセラレーション、推奨 |
同時にインストールできるのは 1 つだけ
2. SkyView リポジトリを追加
推奨方法:ワンクリックで移動。 HA にアクセスできる端末で本ページを開き、下のバッジをクリックすると、my.home-assistant.io が自動的にあなたの HA を見つけてリポジトリアドレスを入力済みにしてくれます。あとは確認するだけです。
初回クリック時は HA のアドレス(例:http://homeassistant.local:8123)の入力を求められますが、以降は記憶されます。ジャンプに失敗した場合や My Home Assistant コンポーネントが未導入の場合は、下記の手動手順を使ってください。
手動での方法:
- 1
アドオンストアを開く
HA の Web 画面 → 設定(Settings)→ アドオン(Add-ons)→ アドオンストア(Add-on Store)
- 2
カスタムリポジトリを追加
右上の三点メニュー → リポジトリ(Repositories)→ 下記の URL を貼り付け → 追加(Add)
- 3
この URL を貼り付け
以下のアドレスをそのままコピー&ペーストしてください:
https://github.com/mrtian2016/yunkan-hassio-addons追加するとページが更新され、アドオンストアの下部に「Yunkan」というセクションが追加されます。そこに yunkan と yunkan-openvino の 2 つのカードがあります。
3. インストールして起動
- 1
バリアントを選ぶ
Intel 機なら
yunkan-openvinoを、それ以外はyunkanをクリックします - 2
インストール
右下の「インストール(Install)」ボタンをクリックし、ダウンロードが終わるまで待ちます(イメージは約 700MB、初回は数分かかります)
- 3
設定(任意)
「設定(Configuration)」タブ:デフォルト設定のままで動作します。特別な要件(ポートの変更、タイムゾーンなど)がある場合はここで調整してください
- 4
起動
「情報(Info)」タブ → 「起動(Start)」ボタン
- 5
自動起動 + Watchdog を有効にする
下にある 2 つのスイッチをどちらもオンにしてください:「起動時に開始」+「Watchdog」。これにより HA ホストの再起動やアドオンのクラッシュ時に自動的に復帰します
- 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 で動かしています。どうすればいいですか?
iGPU アクセラレーションが効かない(yunkan-openvino バリアント)
devices: [/dev/dri:/dev/dri:rwm] が設定されており、理論上は自動的にパススルーされます。失敗する主な原因は、ホストに内蔵 GPU がない(HA Supervisor → Host system → CPU が Intel かどうかを確認)、または HA OS のカーネルがその機種の iGPU に対応していない、のいずれかです。yunkan(CPU)バリアントに戻しても引き続き動作します。バリアントを切り替える際は上書きインストールしない
このページは役に立ちましたか?