fnOS デプロイ
fnOS は Debian 12 ベースで、docker をファーストクラスでサポートしています。本ページでは 2 つのインストール方法を紹介します:アプリセンターに fpk をアップロードするワンクリックインストール(最も手軽)、または docker compose による手動デプロイ(N100 / N305 / N355 などの Intel 機種は iGPU アクセラレーションを利用可能)。
1. 対応機種 & 推奨バリアント
| 機種 | CPU | 推奨バリアント |
|---|---|---|
| fnOS 公式フラッグシップ機 | Intel N100 / N305 / N355 | openvino |
| DIY 機 | 第 11/12/13 世代 i3-i5 + Iris Xe | openvino |
| DIY 機 | NVIDIA GTX/RTX | cuda または trt(VRAM ≥ 8GB) |
| CPU のみ | iGPU なし | cpu |
2. どちらのインストール方法を選ぶか
| インストール方法 | 入り口 | 向いている人 | iGPU / 独立 GPU アクセラレーション |
|---|---|---|---|
| fpk ワンクリックインストール | アプリセンター → ローカルインストール → fpk をアップロード | 一般家庭ユーザー · 手間をかけたくない方 | 現在非対応(推論は CPU で実行) |
| docker compose | docker → カスタムプロジェクト → compose をアップロード | iGPU / 独立 GPU アクセラレーションを使いたい · 柔軟な設定変更が必要な方 | 対応(/dev/dri パススルー) |
選び方
/dev/dri デバイスパススルーを注入できないため、iGPU アクセラレーションは docker compose でのみ利用できます。3. 方法 1:アプリセンターでのワンクリックインストール(fpk · 推奨)
fnOS アプリパッケージ yunkan-latest.fpk をダウンロード
fnOS アプリセンター用インストールパッケージ · アップロードするだけで導入 · インストール時にイメージを自動でオンライン取得
- 1
fpk をダウンロード
上のボタンをクリックして
yunkan-latest.fpkをパソコンにダウンロードします(fnOS 内蔵のブラウザで直接 NAS にダウンロードすることもできます)。 - 2
アプリセンター → ローカルインストール を開く
fnOS デスクトップ → アプリセンター → 右上の ローカルインストール(バージョンによっては「手動インストール」と表記)。
- 3
fpk をアップロードしてインストール
先ほどダウンロードした
yunkan-latest.fpkを選択してアップロードを確定すると、fnOS がインストールパッケージの解析を開始します。 - 4
インストールウィザードに入力
表示されるウィザードでは 3 つの項目を入力します:バリアント(cpu / openvino、デフォルトは openvino)、イメージバージョン(デフォルトは latest)、公開ドメイン(リバースプロキシ経由で公開する場合のみ入力し、LAN 内利用なら空欄のままで構いません)。
- 5
自動デプロイを待つ
fnOS が自動的にイメージを
docker pullし、データ共有フォルダを作成し、docker compose upを実行します。完了するとデスクトップに SkyView のアイコンが表示されます。初回のイメージ取得はネットワーク状況により数分かかります。 - 6
Setup ウィザードに進む
SkyView のアイコンをクリックするか、ブラウザで
http://<fnOS IP>:23406/を開いて Setup ウィザード から管理者アカウントを作成します。
データの保存場所
yunkan-data(データベース / 設定 / ログ)と yunkan-recordings(録画)。どちらも fnOS ファイルマネージャーと SMB から参照できます。録画用フォルダは fnOS のシステム設定で大容量ボリュームへ個別に移動でき、状態用フォルダには影響しません。fpk 方式の 2 つの制限
/dev/dri の iGPU をマウントしないため推論は CPU で実行されます(openvino バリアントは CPU パスにフォールバックします)。② NVIDIA の cuda / trt バリアントには対応していません。iGPU / 独立 GPU アクセラレーションが必要な場合は、下記の docker compose 方式に切り替えてください。4. 方法 2:docker compose による手動デプロイ(iGPU アクセラレーション利用可能)
fnOS の「docker → カスタムプロジェクト」から、compose に直接 /dev/dri をパススルーさせることで、N100 / N305 などの Intel 機種で iGPU を実際に推論に使わせます。後から設定を柔軟に変更しやすいのも利点です。
4.1 事前準備
- 1
docker がインストール済みか確認
fnOS コンソール → アプリセンター → docker(工場出荷時にプリインストール済み)。または SSH で
docker --versionを実行すると出力が表示されるはずです - 2
データディレクトリを作成
fnOS ファイルマネージャー →
/vol1/1000/の下にyunkan/を新規作成、または SSH でmkdir -p /vol1/1000/yunkanを実行します(/vol1/1000/は fnOS の慣例的なユーザーデータパスです)
4.2 compose ファイルの取得
以下の 3 つの方法からいずれか 1 つを選んでください:
ブラウザで compose.yml をダウンロード
fnOS 専用 · openvino バリアント · Web 管理画面からのオンラインアップグレードに対応
または SSH で wget を使う:
ssh <ユーザー名>@<fnOS IP>
cd /vol1/1000/yunkan
wget https://yun-kan.com/compose/fnos.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:
- /vol1/1000/yunkan/data:/app/data
- /vol1/1000/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=yunkan4.3 SkyView を起動
方法 A · SSH:
cd /vol1/1000/yunkan
docker compose up -d
docker logs -f yunkan方法 B · Web UI:fnOS コンソール → docker → プロジェクト → 新規作成 → compose.yml をアップロード → 起動。
起動後、ブラウザで http://<fnOS IP>:23406/ を開いて Setup ウィザード に進んでください。
5. ポートとファイアウォール
fnOS はデフォルトで 8088 を自身の Web パネルに使用しており、SkyView の 23406 系ポートとは衝突しません。fnOS はデフォルトでポートをブロックしないため、LAN 内であればそのままアクセスできます。インターネットに公開する場合は必ずリバースプロキシ + HTTPS を利用してください。
6. よくある質問
iGPU が動作しない
ls /dev/dri/ を実行すると card0 と renderD128 が表示されるはずです。表示されない場合は dmesg | grep i915 でドライバが正常にロードされているか確認してください。一部の機種では BIOS で iGPU が無効になっているため、BIOS に入って Internal Graphics を有効にしてください。注意:fpk ワンクリックインストールでは iGPU をパススルーしません。iGPU アクセラレーションを使うには docker compose 方式をご利用ください。アップグレード:fpk でインストールした場合は fnOS のアプリセンターから直接アップグレードできます(またはウィザードでイメージバージョンを変更して再インストール)。docker compose でインストールした場合は Web 管理画面からワンクリックでオンラインアップグレードできるほか、手動で docker compose pull && docker compose up -d を実行することもできます。
このページは役に立ちましたか?