--- title: NexCMP のインストール description: UbuntuへのNexCMPの1行インストーラーによるインストール手順（パラメータ、インストーラーの動作、TLSとnginx、セットアップウィザードへのアクセス方法）。 url: https://nexcmp.com/ja/docs/getting-started/installation/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # NexCMP のインストール {#install-nexcmp} インストーラーは、ライセンスサーバーから提供される単一のスクリプトです。マシンのチェック、ライセンスのアクティベーション、プログラムのダウンロードと検証、サービスのインストール、および（オプションで）Let's Encrypt 証明書を使用した nginx のセットアップを行います。 ## 始める前に {#before-you-start} - [requirements](https://nexcmp.com/ja/docs/getting-started/requirements/) を満たすサーバーと root アクセス権限。 - [license page](https://nexcmp.com/licenses) からの**ライセンスキー**と**メインドメイン** — [License and purchase](https://nexcmp.com/ja/docs/getting-started/license-and-purchase/) を参照してください。 - ドメインの DNS レコード — [DNS and Cloudflare](https://nexcmp.com/ja/docs/getting-started/dns-and-cloudflare/) を参照してください。先にインストールしてから後で DNS を修正することもできます。インストーラーが不足している項目を通知するため、そのまま再度実行するだけです。 ## インストール {#install} 1. サーバーにログインし、root になります（または `sudo` を付与します）。 2. ライセンスページからコマンドを実行します。外観は以下のようになります: ```bash curl -fsSL https://nexcmp.com/install.sh | sudo bash -s -- \ --license NXC-XXXXX-XXXXX-XXXXX-XXXXX \ --domain cloud.example.com \ --email admin@example.com ``` 3. チェックマークが表示されるまで待ちます。クリーンインストールには数分かかります。初回起動時にはデータベーススキーマが作成されるため、低速なディスクでは最大 1 分ほどかかることがあります。 4. 最後にまとめをお読みください。ポータルおよび管理画面の URL、**セットアップコード**、および次の手順が表示されます。 ![ポータル URL、管理画面 URL、および1回限りのセットアップコードを表示して完了するインストーラー](https://nexcmp.com/ja/docs/images/getting-started/installation-01-finish.webp) ## パラメータ {#parameters} | パラメータ | デフォルト | 意味 | |---|---|---| | `--license KEY` | 初回インストール時に必須 | ライセンスキー。 | | `--domain NAME` | 初回インストール時に必須 | メインドメイン。ライセンスと一致している必要があります。`https://` および末尾のパスは削除されます。 | | `--email ADDRESS` | なし | Let's Encrypt の有効期限通知用の連絡先メールアドレス。指定しない場合、証明書はメールアドレスなしで登録されます。 | | `--port N` | `3000` | パネルのローカルポート（1～65535）。 | | `--no-nginx` | オフ | nginx / TLS のインストールや設定を行いません。独自ののリバースプロキシを実行している場合や、まず NexCMP を確認したい場合に使用します。 | | `--behind-cloudflare` | 自動検出 | 「ドメインが Cloudflare でプロキシされている」モードを強制します。通常は DNS から検出されます。 | | `--channel NAME` | `stable` | リリースチャネル。 | パラメータを指定せずにインストーラーを**再度実行**すると、保存された設定（`/etc/nexcmp/install.conf`）が再利用され、データ、設定、アカウントを維持したまま安全にアップグレードされます。それこそが `sudo nexcmp update` が行っていることです。 ## インストーラーの動作 {#what-the-installer-does} 1. **マシンのチェック** — Ubuntu 22.04/24.04、x86_64、2 GB 以上の RAM、8 GB 以上の空きディスク。 2. **必要なパッケージをインストール**します（`curl`、`zstd`、`openssl`、`python3`、`openssh-client` など）。 3. **サービスユーザー** `nexcmp` および以下のディレクトリを作成します：`/opt/nexcmp`（プログラム、root所有、サービスからは読み取り専用）、`/etc/nexcmp`（設定）、`/var/lib/nexcmp`（データ）、`/var/log/nexcmp`。 4. ドメインの**ライセンスを有効化**し、このマシンの固定インスタンスIDを保存します。 5. **利用可能な最新のリリースをダウンロード**し、SHA-256およびEd25519署名を検証します。有効な署名がないリリースは拒否されます。新しく実行中のバージョンをダウングレードすることはありません。 6. **設定とsystemdユニット**（`nexcmp`、`nexcmp-vmd`、`nexcmp-update`）を書き込んでサービスを起動し、`/healthz`からの応答を待ちます。 7. **nginxとTLSをセットアップ**します（`--no-nginx`でない限り）：certbot（webrootチャレンジ）を使用して、ドメインおよびその名前も名前解決する場合は`admin.` / `partner.`用のLet's Encrypt証明書を取得します。DNSがまだこのサーバー（またはCloudflare）を指していない場合は、このステップをスキップしてその旨を表示します。 8. URLと、管理者がまだ存在しない場合は**セットアップコード**を含む**サマリーを表示**します。 ## パネルのポート（3000） {#the-panel-port-3000} - 初回インストール時、パネルは `0.0.0.0:3000` でリッスンするため、`http://:3000/setup` でセットアップウィザードを開くことができます。 - ウィザードが完了し**かつ**TLSが有効になると、パネルは `127.0.0.1` でのみリッスンし、nginxが `https://` をそこにプロキシします。 - 緊急時（nginxの故障、DNSの誤設定など）には、一定時間ポートを開くことができます：`sudo nexcmp open-port 30`（30分間、その後自動的に閉じます）。またはSSHトンネルを使用します：`ssh -L 3000:127.0.0.1:3000 `を実行し、`http://127.0.0.1:3000/`にアクセスします。 ::: warning プレーンHTTP ポート3000はプレーンHTTPです。信頼されたネットワーク上でのセットアップウィザード、またはSSHトンネル経由でのみ使用してください。開放したままにしないでください。 ::: ## パブリックドメインなしでのインストール（ラボまたはテスト） {#installing-without-a-public-domain-lab-or-test} まだDNSがないマシンにインストールすることもできます： ```bash curl -fsSL https://nexcmp.com/install.sh | sudo bash -s -- \ --license NXC-XXXXX-XXXXX-XXXXX-XXXXX --domain lab.example.com --no-nginx ``` その後、SSHトンネル経由でウィザードを開きます（`ssh -L 3000:127.0.0.1:3000 `、`http://127.0.0.1:3000/setup`にアクセス）。DNSが設定されたら、`--no-nginx`なしでインストーラーを再実行します。 ## DockerおよびKubernetes {#docker-and-kubernetes} 公開されたコンテナイメージはありません。インストーラー（ネイティブなsystemdインストール）がサポート対象のインストール方法です。 ## 確認 {#verify} ```bash sudo nexcmp status ``` バージョン、`nexcmp: active`、`nexcmp-vmd: active`、`healthz: ok`、およびウィザードが完了するまではセットアップコードが表示されるはずです。[setup wizard](https://nexcmp.com/ja/docs/getting-started/setup-wizard/)に進みます。 何らかの問題が発生した場合は、[Installation errors](https://nexcmp.com/ja/docs/troubleshooting/installation-errors/)を参照してください。