飛牛 FnOS デプロイガイド
飛牛 FnOS は、NAS（家庭用ストレージサーバー）向けに設計されたシステムで、コアなユーザーによって開発されています。AI ローカルモデルを内蔵し、家庭や企業でのデータ管理を便利にします。ここでは飛牛 FnOS に AMMDS をデプロイする方法を紹介します。
デプロイ方法
AMMDS は飛牛 FnOS で 2 つのインストール方法を提供しています：
- FPK オフラインアプリインストール：飛牛 FnOS のアプリセンターから手動インストール。ほとんどのユーザーに最適
- Docker インストール：Docker コンテナでデプロイ。コンテナに詳しいユーザー向け
FPK オフラインアプリインストール
ダウンロード
公式リリースアドレス
AMMDS Offline FnNas GitHub Releases
利用可能なインストールパッケージ
| ファイル名 | タイプ | 説明 |
|---|---|---|
AMMDS-Offline-FnNas.fpk | FPK | AMMDS オフラインインストールパッケージ。飛牛 FnOS システム用 |
ダウンロード方法
インストールパッケージをローカル PC にダウンロードすることも、飛牛デバイス上で直接ダウンロードすることもできます。
インストール手順
-
インストールを開始
アプリセンターを開き、左下の手動インストールをクリック。ダウンロードした FPK ファイルを選んでインストールをクリックします。
-
インストールを確認
インストール確認画面で同意をクリックしてインストールを進めます。
-
ライセンスを確認
インストールライセンスの内容をよく読んで、条項を理解してください。
-
インストール場所を選択
空き容量が十分にあるディスクを選んでインストールします。
-
管理者パスワードを設定
AMMDS 管理画面のログインパスワードを設定します。強力なパスワードを推奨します。
-
アクセスポートを設定
AMMDS のアクセスポートを設定します。デフォルトは 9523 です。 サービス利用規約を読み、同意をクリックします。
-
インストールを開始
最後の確認画面で確定をクリックしてインストールを開始します。
-
インストール完了を待つ
インストール中はプログレスバーが表示されます。しばらくお待ちください。エラーが出た場合は指示に従うか、旧バージョンの FPK を試してみてください。
-
インストール成功を確認
インストールが完了すると、インストール済みアプリ一覧に AMMDS が表示されます。
インストールディレクトリ
ファイル管理 → アプリファイルで、AMMDS のインストールディレクトリを確認できます。
Docker インストール
イメージのダウンロード
-
イメージを検索
Docker アプリを開き、初期化が終わったら左メニューのイメージレポジトリをクリックし、AMMDS のイメージを検索します。
-
イメージを選択
ダウンロード数が最も多いイメージを選びます。完全なイメージ名は
qyg2297248353/ammdsです。
-
バージョンを選択
デフォルトバージョンは
latestです。お使いのデバイスが古い場合、latestをサポートしていない可能性があります。その場合はタグの末尾がol8のバージョンを選んでください。
-
ダウンロード完了を待つ
ローカルイメージでダウンロードの進捗を確認できます。ダウンロードが完了すると実行ボタンが表示されます。
コンテナの作成と設定
-
コンテナを作成
実行ボタンをクリックしてデプロイを開始します。 コンテナ名はお好みで（例：
ammds）。 デバイスの性能に合わせて適切なリソースを割り当てます。 起動時に自動実行をオンにできます。
-
ポート設定
詳細設定でポートマッピングを設定します：
- デフォルトのコンテナポートは 80（TCP）
- アクセスポートを 9523（または他の使用可能なポート）に変更
-
ストレージ設定
ローカルディレクトリをコンテナにマウントすることをおすすめします。これでデータが失われません：
- デフォルトでは飛牛が一時ストレージディレクトリを作成しますが、システムに削除される可能性があります
- 対応するディレクトリを手動で作成し、コンテナにマウントすることを推奨します
-
設定を確認
すべての設定が正しいことを確認したら、作成後に起動にチェックを入れます。
実行と管理
-
実行状態を確認
コンテナ一覧で AMMDS が実行中であることを確認できます。右側の三点リーダーですばやく操作できます。
-
アプリの詳細を確認
コンテナをクリックして詳細ページに入ります。
-
実行ログを確認
ログを表示をクリックして実行状態やダウンロードの進捗を確認できます。
:::info 初回起動のヒント 初回インストール時、システムは必要なリソースファイルを自動ダウンロードします。しばらくお待ちください。ログにダウンロードの進捗が表示されます。 :::
インストール完了
インストールが完了したら、ブラウザから AMMDS 管理画面にアクセスして使い始められます。
高度な試み
Docker Compose（コンテナ管理ツール）に詳しければ、Compose ファイルを使ってデプロイすることもできます。より柔軟な設定が可能です。
警告と注意事項
セキュリティ警告
:::danger 重要なセキュリティのヒント
- 公式ソース：AMMDS インストールパッケージは公式 GitHub Releases ページからのみダウンロードしてください。サードパーティの配布元は使わないでください
- パスワードのセキュリティ：強力なパスワードを設定し、定期的に変更しましょう
- ポートのセキュリティ：デフォルトポートを変更し、攻撃されるリスクを減らしましょう
:::
システム要件
:::info システム構成要件
最小要件
- オペレーティングシステム：飛牛 FnOS 最新バージョン
- プロセッサ：Intel Core i3 または同等のパフォーマンス
- メモリ：4GB RAM
- ディスク容量：少なくとも 10GB の空き容量
- ネットワーク：ブロードバンドインターネット接続
推奨要件
- オペレーティングシステム：飛牛 FnOS 最新バージョン
- プロセッサ：Intel Core i5 または同等のパフォーマンス
- メモリ：8GB RAM 以上
- ディスク容量：20GB の空き容量
- ネットワーク：安定したブロードバンドインターネット接続
:::
使用上の注意事項
- データバックアップ：設定ファイルと重要なデータは定期的にバックアップしましょう
- リソース管理：ディスク容量に注意し、不要なファイルはこまめに削除しましょう
- ネットワーク接続：リソースダウンロードやアップデート時は、安定したネットワークを確保してください
- システムメンテナンス：飛牛 FnOS システムは定期的に更新しましょう
トラブルシューティング
よくある問題
- インストール失敗：ディスク容量とネットワーク接続を確認してください
- 起動異常：実行ログを確認してエラー情報を取得してください
- アクセス失敗：ポート設定とファイアウォール設定を確認してください
- アップグレード失敗：旧バージョンをアンインストールしてから新バージョンをインストールしてみてください
連絡先
解決できない問題が発生した場合は、公式 GitHub リポジトリに Issue を提出してください。
ベストプラクティス
- 定期更新：AMMDS は常に最新バージョンを保ちましょう
- 適切な設定：デバイスの性能に合わせてパラメータを適切に設定しましょう
- 安全な使用：公式ドキュメントの手順に従い、コア設定ファイルはむやみに編集しないでください
- コミュニティへの参加：コミュニティに参加して、経験を共有したりフィードバックを送ったりしましょう