メインコンテンツまでスキップ

サーバーへのインストール

Qubix はお客様自身のサーバー上で動作します。インストールコマンドを1つ実行するだけで、スタック全体 (データベース、バックエンド、Webサーバー、補助ツール)が起動します。必要なのは、SSH アクセスと Docker が使用可能なクリーンな Linux サーバーのみです。

サーバー要件

インストーラーはインストール開始前にサーバーを確認し、明らかにスペックが不足しているマシンでは続行を拒否します。推奨最小構成は以下のとおりです。

リソース推奨最小構成
CPU4 vCPU
RAM8 GB
ディスク20 GB SSD または HDD

これらの値はインストーラーが推奨するものです。これを下回る環境でも動作しますが、トラフィックの多い日は ClickHouse が低速になる旨の警告が表示されます。ディスク空き容量 10 GB はハードフロアです — これを下回るとインストールが停止します。

ディスクの種類はトラフィックのサービングには影響しません — SSD と HDD のどちらでも動作し、HDD でコストを抑えられます;SSD が速度差を生むのは大規模なデータ量での管理レポートのみです。20 GB は開始に十分です:プラットフォーム本体と数千件のクリエイティブを収められ、トラフィック履歴の容量増加はほとんどありません。特定のディスク容量でどれだけのトラフィックとクリエイティブ数に対応できるかは、サーバーの選び方をご参照ください。

いくつかの必須条件があります。

  • 64ビット Linux サーバー(VPS/VDS または専用マシン)。個人のコンピューターや共有ホスティングは不可です。
  • docker compose プラグイン(V2)を含む Docker。旧来のスタンドアロン版 docker-compose(V1)はサポートされていません。インストーラーが検出した場合は停止します。
  • サーバーが Qubix イメージを取得するための、アウトバウンド HTTPS 接続。
クリーンなサーバー

Qubix 専用のサーバーにインストールしてください。スタックはポート 80443 (および Cloudflare オプションの場合は 8443)が空いていることを前提としています。別の Web サーバーがすでにこれらのポートを使用している場合は、先に解放するか、ウィザードで後述の Cloudflare オプションを選択してください。

インストール

  1. root ユーザーとして SSH でサーバーに接続します。

  2. インストールコマンドを実行します。

    Bash
    curl -sSL https://qubix.pro/install.sh | bash

    (または wget -qO- https://qubix.pro/install.sh | bash

    ターミナルでのインストーラーバナーとスタック起動の様子

  3. インストーラーは Qubix のバナーを表示し、サーバーを確認した後、いくつかの質問(インストールフォルダー、公開するネットワークインターフェイス)をします。その後、スタックを取得して起動します。すべてが起動したことが報告されるまでお待ちください。

中断しないでください

インストーラーが完了するまで待ってください。途中で停止すると、半端な状態のスタックが残る可能性があります。その場合、最も安全な復旧方法はインストールフォルダーを削除し、クリーンなサーバーで再度コマンドを実行することです。

インストール後の構成

インストーラーにより、Qubix を構成するコンテナ群が起動します。アナリティクスデータベース、Qubix バックエンド、Webサーバー、自動更新・証明書・AI ヘルパーです。これらを手動で管理する必要はありません。Qubix がすべて管理します。

ブラウザでのセットアップ完了

スタックが起動すると、インストーラーが次のようなリンクを表示します。

http://<your-server-ip>:7000/install?k=…

そのリンクを完全な形でブラウザで開いてください(?k=… キーが必要です)。セットアップウィザードが開き、Qubix へのアクセス方法の選択、ライセンスの入力、最初の管理者の作成を行います。

ターミナルに表示されたウィザードリンクの行

リンクは1回限り有効

セットアップウィザードは完了するまでのみアクセス可能です。最初の管理者が作成されると、このリンクは無効になります。これは正常な動作です。以降はパネル自体のアドレスからログインしてください。

次のステップ