インストールエラー
インストーラーは最初のエラーで停止し、✗で始まる赤い行を出力します。原因を修正して同じコマンドを再度実行してください。インストーラーは何度実行しても安全です。情報メッセージは•で、成功したステップは✓で始まります。
マシンのチェック
| メッセージ | 原因 | 対処法 |
|---|---|---|
must be run as root (sudo) | root権限で実行されていません | コマンドの前にsudoを付けるか、rootとして実行してください。 |
only Ubuntu 22.04/24.04 is supported (this host: …) | 別のディストリビューションまたはバージョン | Ubuntu 22.04または24.04サーバーを使用してください。 |
only x86_64 is supported | ARMまたはその他のCPU | x86_64サーバーを使用してください。 |
requires ≥ 2 GB RAM (host has … MB) | メモリが不足しています | RAMを追加してください。 |
requires ≥ 8 GB free disk space on / (… GB available) | ルートファイルシステムの空き容量がほぼありません | 空き容量を確保するか、/を拡張してください。 |
missing --license / missing --domain | これらのパラメータを指定せずに最初にインストールしました | 両方を指定してください — Installationを参照してください。 |
unknown argument: … | パラメータの入力ミス | スペルを確認し、--helpを指定して実行してください。 |
apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running) | パッケージマネージャーがロックされています | 数分待ってから（クリーンなUbuntuは起動後に自動アップデートを実行するため）、再実行してください。 |
… is a symlink — aborting | /opt/nexcmpまたは/etc/nexcmpがシンボリックリンクになっています | 実際のディレクトリに置き換えてください。セキュリティ上の理由から、インストーラーはシンボリックリンクを拒否します。 |
ライセンス認証
| メッセージ | 原因 | 対処法 |
|---|---|---|
cannot connect to https://nexcmp.com | ライセンスサーバーへのアウトバウンドHTTPS通信がありません | サーバーのDNS、ファイアウォール、プロキシを確認してください: curl -I https://nexcmp.com。 |
license activation failed (HTTP …): <message> | ライセンスサーバーによってキーが拒否されました | メッセージを確認してください：無効なキー、ライセンスに一致しないドメイン、停止または失効したライセンス。nexcmp.com/licensesでライセンスページを確認してください。 |
no release available for this license yet | ライセンスにダウンロード可能なリリースがありません | 営業担当にお問い合わせください。Supportをご覧ください。 |
ダウンロードと検証
| メッセージ | 原因 | 対処法 |
|---|---|---|
failed to download release X | ダウンロード中のネットワーク問題 | 再実行してください。 |
sha256 mismatch (… ≠ …) | ファイルが破損しているか、改変されて届きました | 再実行してください。問題が続く場合は、プロキシがダウンロードを書き換えている可能性があります。別のネットワークからお試しください。 |
release X is unsigned — refusing to install | サーバーから署名が提供されませんでした | 絶対にバイパスせず、サポートにお問い合わせください。 |
INVALID SIGNATURE for version X — aborting | Ed25519署名の検証に失敗しました | インストールしないでください。サポートにお問い合わせください。これはファイルが公式リリースではないことを意味します。 |
openssl failed to read public key | 非常に古い、または破損したOpenSSL | opensslパッケージをアップデートしてください。 |
invalid version: … | サーバーからの予期しないデータ | 再実行してください。解決しない場合はサポートにお問い合わせください。 |
サービスの起動
| メッセージ | 原因 | 対処法 |
|---|---|---|
service failed to start — check: journalctl -u nexcmp -n 50 | パネルが3分以内に/healthzに応答しませんでした | ジャーナルを確認してください。一般的な原因：ポート（デフォルトは3000）がすでに使用されている（`ss -ltnp |
nginxとTLS
| メッセージ | 原因 | 対処法 |
|---|---|---|
DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS | AまたはAAAAレコードが存在しないか、間違っています | DNS and Cloudflareを参照してから再実行してください。 |
certbot could not get a certificate yet — re-run the installer once DNS has settled | Let's Encryptの検証に失敗しました（ポート80がブロックされている、DNSが伝播していない、レート制限） | ポート80を開放し、DNSの伝播を待ってから再実行してください。/var/log/letsencrypt/letsencrypt.logを確認してください。 |
certbot could not renew now — keeping the existing certificate | 一時的な更新失敗 | 問題ありません。後で再実行してください。 |
nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t) | 別のnginxサイトと競合しています（同じserver_name、重複する設定） | sudo nginx -tを実行して競合を修正してから、再実行してください。 |
apt-get could not install nginx / certbot、またはE: Failed to fetch … 404 Not Found | パッケージマネージャーがロックされているか、サーバーのパッケージインデックスが古くなっています（しばらくアップデートされていないテンプレートイメージで典型的です） | sudo apt-get updateを実行し、他のaptプロセスが終了するのを待ってから、インストーラーを再実行してください。 |
openssl could not create the self-signed certificate | OpenSSLの問題 | opensslをアップデートしてから再実行してください。 |
インストール後
| 症状 | 原因 | 対処法 |
|---|---|---|
ブラウザでhttps://<domain>を開けない | DNSまたはTLSの準備ができていません | sudo nexcmp status; emergency accessを使用してください。 |
ERR_TOO_MANY_REDIRECTS | CloudflareのSSLモードがFlexibleになっている | **Full (strict)**を設定する — 詳細。 |
| ウィザードで「セットアップコード」が正しくないと表示される | 入力ミス、または以前のインストールのコードである | sudo nexcmp statusを実行し、現在のコードをコピーする。 |
| ライセンスが HTTP 421 を返す | /var/lib/nexcmp内のファイルの所有者が root になっている | sudo nexcmp fix-owner、次にsudo systemctl restart nexcmpを実行する。 |