• 日本語

      • インストール方法

      現在のバージョンはバックアップ・リストア形式でデプロイされます。今後のバージョンでは、既存のシステムにソリューションを統合しやすくするため、増分マイグレーション形式に変更される可能性があります。

      CRM 2.0 ソリューションをお客様自身の NocoBase 環境に迅速かつスムーズにデプロイしていただくために、2 つのリストア方法を提供しています。ユーザーエディションと技術的な背景に合わせて、最適なものを選択してください。

      開始する前に、以下を確認してください：

      重要事項：

      • 本ソリューションは PostgreSQL 16 データベースに基づいて作成されています。環境で PostgreSQL 16 を使用していることを確認してください。
      • DB_UNDERSCORED は true にしないでください：docker-compose.yml ファイルを確認し、DB_UNDERSCORED 環境変数が true に設定されていないことを確認してください。そうでない場合、ソリューションのバックアップと競合し、リストアに失敗します。

      方法 1：バックアップマネージャーを使用してリストア（プロフェッショナル/エンタープライズ版ユーザー推奨）

      この方法は、NocoBase 内蔵の「バックアップマネージャー」（プロフェッショナル/エンタープライズ版）プラグインを使用してワンクリックでリストアを行うもので、操作が最も簡単です。ただし、環境とユーザーエディションに一定の要件があります。

      主な特徴

      • メリット：
        1. 操作が便利：UI 画面で完結し、プラグインを含むすべての設定を完全にリストアできます。
        2. 完全なリストア：テンプレート印刷ファイルや、テーブル内のファイルフィールドでアップロードされたファイルなど、すべてのシステムファイルをリストア可能であり、機能の完全性を保証します。
      • 制限事項：
        1. プロフェッショナル/エンタープライズ版限定：「バックアップマネージャー」はエンタープライズ向けプラグインであり、プロフェッショナル/エンタープライズ版ユーザーのみ利用可能です。
        2. 環境要件が厳格：データベース環境（バージョン、大文字小文字の区別設定など）が、バックアップ作成時の環境と高度に互換性がある必要があります。
        3. プラグインの依存関係：ソリューションにローカル環境にない商用プラグインが含まれている場合、リストアは失敗します。

      操作手順

      ステップ 1：【強く推奨】 full イメージを使用してアプリケーションを起動する

      データベースクライアントの欠如によるリストア失敗を避けるため、full バージョンの Docker イメージを使用することを強く推奨します。これには必要なすべての関連プログラムが内蔵されており、追加設定なしで使用できます。

      イメージをプルするコマンド例：

      docker pull nocobase/nocobase:beta-full

      その後、このイメージを使用して NocoBase サービスを起動します。

      注：full イメージを使用しない場合、コンテナ内に pg_dump データベースクライアントを手動でインストールする必要があり、プロセスが煩雑で不安定になる可能性があります。

      ステップ 2：「バックアップマネージャー」プラグインを有効にする

      1. NocoBase システムにログインします。
      2. プラグイン管理 に移動します。
      3. バックアップマネージャー プラグインを見つけて有効にします。

      ステップ 3：ローカルバックアップファイルからリストアする

      1. プラグインを有効にした後、ページを更新します。
      2. 左側メニューの システム管理 -> バックアップマネージャー に移動します。
      3. 右上の ローカルバックアップからリストア ボタンをクリックします。
      4. ダウンロードしたバックアップファイルをアップロードエリアにドラッグ＆ドロップします。
      5. 送信 をクリックし、システムがリストアを完了するまで待ちます。このプロセスには数十秒から数分かかる場合があります。

      注意事項

      • データベースの互換性：これはこの方法で最も重要な点です。PostgreSQL データベースのバージョン、文字セット、大文字小文字の区別設定がバックアップ元のファイルと一致している必要があります。特に schema 名は一致している必要があります。
      • 商用プラグインの一致：ソリューションに必要なすべての商用プラグインを所有し、有効にしていることを確認してください。そうでない場合、リストアは中断されます。

      方法 2：SQL ファイルを直接インポート（汎用、コミュニティ版に最適）

      この方法は、データベースを直接操作してデータをリストアするため、「バックアップマネージャー」プラグインを経由せず、プロフェッショナル/エンタープライズ版プラグインの制限がありません。

      主な特徴

      • メリット：
        1. エディション制限なし：コミュニティ版を含むすべての NocoBase ユーザーに適用されます。
        2. 高い互換性：アプリケーション内の dump ツールに依存せず、データベースに接続できれば操作可能です。
        3. 高い耐障害性：ソリューションに所有していない商用プラグインが含まれている場合、関連機能は有効になりませんが、他の機能の正常な使用には影響せず、アプリケーションは正常に起動できます。
      • 制限事項：
        1. データベース操作能力が必要：.sql ファイルの実行方法など、基礎的なデータベース操作能力が必要です。
        2. システムファイルの紛失：この方法ではすべてのシステムファイルが失われます。これにはテンプレート印刷ファイルや、テーブル内のファイルフィールドでアップロードされたファイルなどが含まれます。

      操作手順

      ステップ 1：クリーンなデータベースを準備する

      インポートするデータのために、新しく空のデータベースを準備します。

      ステップ 2：.sql ファイルをデータベースにインポートする

      ダウンロードしたデータベースファイル（通常は .sql 形式）を取得し、その内容を前のステップで準備したデータベースにインポートします。実行方法は環境によって異なります：

      • オプション A：サーバーのコマンドライン経由（Docker を例に） Docker で NocoBase とデータベースをインストールしている場合、.sql ファイルをサーバーにアップロードし、docker exec コマンドを使用してインポートを実行できます。PostgreSQL コンテナ名が my-nocobase-db、ファイル名が nocobase_crm_v2_sql_260327.sql であると仮定します：

        # sql ファイルをコンテナ内にコピー
docker cp nocobase_crm_v2_sql_260327.sql my-nocobase-db:/tmp/
# コンテナに入りインポートコマンドを実行
docker exec -it my-nocobase-db psql -U nocobase -d nocobase -f /tmp/nocobase_crm_v2_sql_260327.sql

      • オプション B：リモートデータベースクライアント経由（Navicat など） データベースのポートが公開されている場合、任意のグラフィカルデータベースクライアント（Navicat、DBeaver、pgAdmin など）を使用してデータベースに接続し、以下の操作を行います：

        1. ターゲットデータベースを右クリックします。
        2. 「SQL ファイルの実行」または「SQL スクリプトの実行」を選択します。
        3. ダウンロードした .sql ファイルを選択して実行します。

      ステップ 3：データベースに接続してアプリケーションを起動する

      NocoBase の起動パラメータ（環境変数 DB_HOST、DB_PORT、DB_DATABASE、DB_USER、DB_PASSWORD など）を、データをインポートしたデータベースを指すように設定します。その後、通常通り NocoBase サービスを起動します。

      注意事項

      • データベース権限：この方法では、データベースを直接操作できるアカウントとパスワードが必要です。
      • プラグインの状態：インポート成功後、システムに含まれる商用プラグインのデータは存在しますが、ローカルに対応するプラグインがインストール・有効化されていない場合、関連機能は表示・使用できません。ただし、これによりアプリケーションがクラッシュすることはありません。

      まとめと比較

      特性方法 1：バックアップマネージャー方法 2：SQL ファイルを直接インポート
      対象ユーザープロフェッショナル/エンタープライズ版ユーザーすべてのユーザー（コミュニティ版を含む）
      操作の容易さ⭐⭐⭐⭐⭐ (非常に簡単、UI 操作)⭐⭐⭐ (基礎的なデータベース知識が必要)
      環境要件厳格、データベースやシステムバージョンなどの高度な互換性が必要一般的、データベースの互換性が必要
      プラグイン依存強い依存関係、リストア時にプラグインがチェックされ、いずれかが欠けているとリストアに失敗します。機能はプラグインに強く依存。データは独立してインポート可能で、システムは基礎機能を備えます。ただし、対応するプラグインがない場合、関連機能は完全に利用不可となります。
      システムファイル完全に保持（印刷テンプレート、アップロードファイルなど）失われる（印刷テンプレート、アップロードファイルなど）
      推奨シーンエンタープライズユーザーで、環境が制御可能かつ一致しており、完全な機能を必要とする場合一部のプラグインが不足しており、高い互換性と柔軟性を求める場合。非プロフェッショナル/エンタープライズ版ユーザー、またはファイル機能の欠如を許容できる場合

      よくある質問

      プロフェッショナル版でも使えますか？エラーは出ませんか？

      そのままご利用いただけます。エラーは発生しません。Demo では一部のエンタープライズ版プラグイン（メール管理、監査ログなど）が使用されていますが、プロフェッショナル版でこれらのプラグインがない場合、対応する機能の入口は表示されません。ただし、システムの他の機能には影響しません。例えば、メールの入口は表示されなくなりますが、リード、商機、注文などのコアモジュールは完全に正常に動作します。

      リストア後はどのバージョンを選べばよいですか？

      最新の beta-full バージョンのイメージ（例：nocobase/nocobase:beta-full）の使用を推奨します。full イメージにはデータベースクライアントなどの依存関係が内蔵されており、リストア時にツール不足で失敗することを防ぎます。

      リストア後にロゴが表示されません

      公式 Demo のロゴにはドメイン制限が設定されているため、ローカルのドメインではロゴを読み込めません。システム設定に移動して、ご自身のロゴを再アップロードしてください。

      ファイルアップロードでエラーが発生します（OSS Key エラー）

      SQL 方式でインストールした後、ファイルアップロード時に OSS 関連のエラーが発生することがあります。解決方法：プラグイン管理 -> ファイルマネージャーに移動し、Local Storage（ローカルストレージ）をデフォルトのストレージスペースに設定して保存すれば、正常にアップロードできるようになります。

      増分アップグレードはどうすればよいですか？

      現時点ではバージョンアップは全量置換となり、カスタム変更は上書きされます。アップグレード前には必ずバックアップを取ってください。増分マイグレーション方式は現在計画中で、プロフェッショナル/エンタープライズ版から優先的にサポートされる予定です。コミュニティ版はマイグレーション管理プラグインがないため、当面のサポートは困難な状況です。

      このチュートリアルが CRM 2.0 システムの円滑なデプロイに役立つことを願っています。操作中に問題が発生した場合は、いつでもお気軽にお問い合わせください！

      Last updated: 2026-04-02