#インストール方法

一体型業務管理システムは CRM 顧客管理、販売管理、ヘルプデスク、プロジェクト管理、固定資産管理、HR 人事管理 の 6 モジュールを網羅します。NocoBase 内蔵の「バックアップマネージャー」プラグインで .nbdata バックアップファイルをワンクリック復元すれば、完全なデータを取得できます。

現バージョンはバックアップ復元方式でデプロイしますが、今後のバージョンでは差分マイグレーション方式に切り替え、既存の NocoBase 環境への組み込みを容易にする予定です。

#操作手順

#Step 1:full イメージでアプリを起動

データベースクライアントなどの周辺コンポーネントがすべて含まれており追加設定が不要な、full 版の Docker イメージを強く推奨します。

docker pull nocobase/nocobase:alpha-full

このイメージで NocoBase サービスを起動します。

#Step 2:「バックアップマネージャー」プラグインを有効化

1. NocoBase システムにログイン
2. 「プラグイン管理」に入る
3. 「バックアップマネージャー」プラグインを見つけて有効化

#Step 3:ローカルバックアップファイルから復元

1. プラグインを有効化したらページを更新

2. 左メニューの「システム管理 / バックアップマネージャー」に進む

   

3. 右上の「ローカルバックアップから復元」ボタンをクリック

4. ダウンロードした nocobase_all_in_one_backup_260521.nbdata ファイルをアップロード領域にドラッグ

   

5. 「送信」をクリックし、復元完了を待つ。通常は数十秒から数分

#注意事項

• データベース互換性 — PostgreSQL のバージョン、文字セット、大文字小文字の感度設定がバックアップ元と一致している必要があり、特に schema 名は完全に一致させる
• 商用プラグインの整合性 — バックアップで使用されている商用プラグインをローカルにすべて有効化しておく必要があり、不足があると復元が中断する。一体型ソリューションが利用する商用プラグインにはメール管理、監査ログ、AI 社員などがある。コミュニティ版にこれらのプラグインが無い場合、該当する入口は表示されませんが、他のモジュールには影響しません

#インストール後の必須設定

復元が完了するとシステムは開けるようになりますが、弊社のデモ環境を指している設定が 2 か所あり、自分の環境に切り替える必要があります。

#1. ファイルストレージエンジン(OSS / ローカル)

デモバックアップのデフォルトストレージエンジンは弊社デモ用の Alibaba Cloud OSS を指しており、Access Key は外部に公開していないため、添付ファイルフィールド、テンプレート印刷、AI 社員アバターのアップロードはすべて失敗します。

通常はローカルストレージに切り替えれば十分で、CDN 高速化や大容量ファイルが必要な場合のみ自前の OSS を使います。

切り替え手順:

1. 「プラグイン管理 / ファイルマネージャー」(または /admin/settings/file-manager に直接アクセス)に進む

2. オプション A — ローカルストレージを使う(最も簡単、セルフホスト向け):

   • 自動作成された「Local Storage(ローカルストレージ)」項目を探す
   • 「編集」をクリックし、設定パネル下部の「デフォルトストレージエンジンに設定」にチェックを入れて送信

   

   注意

   Docker デプロイの場合、ローカルストレージはコンテナ内にあり、コンテナを削除するとファイルが失われます。本番環境では volume をマウントするかクラウドストレージへの切り替えを推奨します。

3. オプション B — 自前の OSS / S3 / COS を使う:

   • 「新規追加」をクリックし、対応するタイプ(Alibaba Cloud OSS / Amazon S3 / Tencent Cloud COS / S3 Pro)を選択
   • Access Key、Bucket、Region、ドメインなどのパラメータを入力し、「デフォルトストレージエンジンに設定」にチェックを入れて送信

   

4. デモにプリセットされた OSS 項目は削除または無効化し、誤用を防ぐ

詳細なパラメータ説明はストレージエンジン概要を参照。

#2. AI 社員の LLM サービスキー

デモバックアップには複数の LLM サービス項目(OpenAI、Claude、Gemini、DeepSeek、Qwen、Kimi など)がプリセットされていますが、入力されているのは弊社の API Key であり、外部では機能しません。AI 社員機能は切り替えるまで利用できません。

設定手順:

1. 「システム設定 / AI 社員 / LLM service」(または /admin/settings/ai/llm-services にアクセス)に進む

   

2. プリセットのサービス一覧は、ドラッグで並び替え、Enabled スイッチで有効/無効を切り替えできる

   

3. 利用予定の各サービスについて:

   • 「編集」をクリック
   • 「API Key」を自分のキーに置き換える(対応するサービス提供元のアカウントから取得:OpenAI、Anthropic、Google AI Studio、DeepSeek、Qwen、Kimi など)
   • プロキシや国内中継を使う場合は「Base URL」を調整
   • 「Enabled Models」では利用するモデルを残し、不要なものは削除

   

4. 下部の「Test flight」で接続性をテストし、通過したら「Submit」で保存

   

5. 利用しないサービスは Disabled にすればよく、削除する必要はない

詳細な設定はLLM サービスの設定を参照。

#よくある質問

#コミュニティ版でも使えますか?エラーは出ますか?

そのまま使え、エラーは出ません。バックアップマネージャーは v2.1.0-alpha.40 からオープンソース化され、コミュニティ版でもインストール可能です。デモではエンタープライズ版プラグイン(メール管理、監査ログ、AI 社員など)を一部使用していますが、コミュニティ版にこれらが無い場合、該当機能の入口は表示されないだけで、他のモジュールには影響しません。例えば監査ログの入口は表示されなくなりますが、CRM、販売、チケット、プロジェクト、資産、HR などのコアモジュールは問題なく利用できます。

#復元後はどのバージョンを選ぶべきですか?

最新の alpha-full イメージ(nocobase/nocobase:alpha-full)を推奨します。full イメージにはデータベースクライアントなどの依存が同梱されており、復元時のツール不足を防げます。

#復元後にロゴが表示されません

公式デモのロゴはドメイン制限が設定されており、ローカルドメインでは読み込めません。「システム設定」から自分のロゴを再アップロードしてください。

#ファイルアップロードでエラー(OSS Key エラー)が出ます

デモバックアップで設定されたストレージエンジンは弊社のデモ用 OSS を指しており、Key は外部に公開していません。「プラグイン管理 / ファイルマネージャー」に進み、「Local Storage(ローカルストレージ)」をデフォルトストレージに設定して保存すれば正常にアップロードできます。

詳細な対処は上記ファイルストレージエンジンセクションを参照。

#多言語の切り替えは?

一体型ソリューションは 20 以上の言語にローカライズ済みです(nb_demo 名前空間)。復元後はデフォルトで中国語表示となるため、他言語に切り替えるには「システム設定 / 対象言語を有効化」してください。

#差分アップグレードはどうすればよいですか?

現バージョンのアップグレードは全置換であり、独自カスタマイズは上書きされます。アップグレード前のバックアップを必ず取得してください。差分マイグレーション方式は計画中です。