fnOS デプロイ

fnOS は Debian 12 ベースで、docker をファーストクラスでサポートしています。本ページでは 2 つのインストール方法を紹介します:アプリセンターに fpk をアップロードするワンクリックインストール(最も手軽)、または docker compose による手動デプロイ(N100 / N305 / N355 などの Intel 機種は iGPU アクセラレーションを利用可能)。

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

機種CPU推奨バリアント
fnOS 公式フラッグシップ機Intel N100 / N305 / N355openvino
DIY 機第 11/12/13 世代 i3-i5 + Iris Xeopenvino
DIY 機NVIDIA GTX/RTXcuda または trt(VRAM ≥ 8GB)
CPU のみiGPU なしcpu

2. どちらのインストール方法を選ぶか

インストール方法入り口向いている人iGPU / 独立 GPU アクセラレーション
fpk ワンクリックインストールアプリセンター → ローカルインストール → fpk をアップロード一般家庭ユーザー · 手間をかけたくない方現在非対応(推論は CPU で実行)
docker composedocker → カスタムプロジェクト → compose をアップロードiGPU / 独立 GPU アクセラレーションを使いたい · 柔軟な設定変更が必要な方対応(/dev/dri パススルー)

選び方

手間をかけずに、N100 / N305 が CPU だけで十分動くなら fpk ワンクリックインストール を選んでください。iGPU / 独立 GPU を実際に推論アクセラレーションへ使いたい場合や compose をカスタマイズしたい場合は、下記の docker compose 方式を使ってください。fnOS のアプリパッケージの仕組み上、fpk の compose テンプレートは静的で /dev/dri デバイスパススルーを注入できないため、iGPU アクセラレーションは docker compose でのみ利用できます。

3. 方法 1:アプリセンターでのワンクリックインストール(fpk · 推奨)

fnOS アプリパッケージ yunkan-latest.fpk をダウンロード

fnOS アプリセンター用インストールパッケージ · アップロードするだけで導入 · インストール時にイメージを自動でオンライン取得

  1. 1

    fpk をダウンロード

    上のボタンをクリックして yunkan-latest.fpk をパソコンにダウンロードします(fnOS 内蔵のブラウザで直接 NAS にダウンロードすることもできます)。

  2. 2

    アプリセンター → ローカルインストール を開く

    fnOS デスクトップ → アプリセンター → 右上の ローカルインストール(バージョンによっては「手動インストール」と表記)。

  3. 3

    fpk をアップロードしてインストール

    先ほどダウンロードした yunkan-latest.fpk を選択してアップロードを確定すると、fnOS がインストールパッケージの解析を開始します。

  4. 4

    インストールウィザードに入力

    表示されるウィザードでは 3 つの項目を入力します:バリアント(cpu / openvino、デフォルトは openvino)、イメージバージョン(デフォルトは latest)、公開ドメイン(リバースプロキシ経由で公開する場合のみ入力し、LAN 内利用なら空欄のままで構いません)。

  5. 5

    自動デプロイを待つ

    fnOS が自動的にイメージを docker pull し、データ共有フォルダを作成し、docker compose up を実行します。完了するとデスクトップに SkyView のアイコンが表示されます。初回のイメージ取得はネットワーク状況により数分かかります。

  6. 6

    Setup ウィザードに進む

    SkyView のアイコンをクリックするか、ブラウザで http://<fnOS IP>:23406/ を開いて Setup ウィザード から管理者アカウントを作成します。

データの保存場所

fpk は自動的に 2 つの fnOS 共有フォルダを作成します: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. 1

    docker がインストール済みか確認

    fnOS コンソール → アプリセンター → docker(工場出荷時にプリインストール済み)。または SSH で docker --version を実行すると出力が表示されるはずです

  2. 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 を使う:

bash
ssh <ユーザー名>@<fnOS IP>
cd /vol1/1000/yunkan
wget https://yun-kan.com/compose/fnos.yml -O compose.yml

または最小構成を貼り付ける

fnOS Web UI → docker → カスタムプロジェクト → YAML エディタから、以下の内容を直接貼り付けることもできます。
yaml
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=yunkan
compose.yml(最小構成)

4.3 SkyView を起動

方法 A · SSH:

bash
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 が動作しない

fnOS 上で SSH から 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 を実行することもできます。

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