SMTPとメールテンプレート
管理画面の場所: System › Settings › Email (
/settings/email) — SMTPタブとEmail templatesタブ。配信ログ:Overview › Support › Sent emails (/support/emails)。
動作内容
NexCMPは、サインアップ認証、パスワードリセット、「VM準備完了」(初期パスワード付き)、請求書、残高不足、更新、トップアップ、サポート返信などのメールを送信します。これらはすべてお客様が用意した1つのSMTPアカウントを経由して送信されます。メッセージとテンプレートは16言語に対応しており、顧客の言語が使用されます。
要件
| 項目 | 要件 |
|---|---|
| SMTPサーバー | 任意のプロバイダーのホスト、ポート、および認証情報(自社サーバー、Brevo、Amazon SES、Mailgun、Google Workspaceなど) |
| ネットワーク | NexCMPサーバーからSMTPホストおよびポート(587 STARTTLS、465 TLS、または25)への外向きTCP |
| 送信元ドメイン | プロバイダー向けにSPFとDKIMが公開されており、DMARCレコードが設定されている、お客様が管理するドメイン |
| 権限 | SMTPアカウントにFromアドレスとしての送信が許可されている必要があります。 |
到達性
「VM準備完了」などのメールにはパスワードが含まれています。送信元ドメインのSPF/DKIM/DMARCがSMTPプロバイダーと一致しない場合、迷惑メールとして判定されます。このページではその点について注意を促しています。
メールプロバイダーの準備
- プロバイダーのパネルで送信ドメインを追加し、検証します(例:
example.com)。 - プロバイダーに表示されるSPF、DKIM、DMARCのDNSレコードを公開します。
- SMTPユーザー(またはAPI-SMTPキー)を作成し、ホスト、ポート、ユーザー名、パスワードを控え置きます。
NexCMP での接続
- System › Settings › Emailを開き、SMTPタブを選択します。
- フォームに必要事項を入力します:
| 項目 | Example | 備考 |
|---|---|---|
| ホスト | smtp.example.net | SMTPサーバー |
| ポート | 587 | |
| セキュリティ | STARTTLS (587) | プロバイダーが必要とするモードを選択します |
| ユーザー名 | smtp-user | |
| パスワード | (非表示) | 書き込み専用:設定されているかどうのみが表示されます |
| 送信元メールアドレス | no-reply@example.com | プロバイダーで承認されている必要があります |
| 送信元名 | Example Cloud | デフォルトではブランド名が使用されます |
| 返信先(オプション) | support@example.com | 顧客からの返信の宛先 |

- Saveをクリックし、Send testをクリックしてご自身のメールアドレスを入力します。
設定はアクセス権が制限されたファイル(smtp.json、モード 0600)に保存され、メールの送信はバックグラウンドワーカー nexcmp-vmd のみが行い、Webサービスはキューイングのみを行います。
確認
- テストメッセージが受信トレイに届きます(迷惑メールフォルダもご確認ください)。メッセージのソースで
dkim=passとspf=passを確認します。 - Support › Sent emails を開きます。各メッセージにはステータス(queued、sent、failed)と配信結果が表示されます。失敗したメッセージは最大3回まで再試行されます。
- ポータルでテスト顧客を登録し、確認メールが届くことを確認します。
メールテンプレートの編集
タブ Email templates には、すべてのテンプレートがキーごとに、対応する言語(例: verify_email、reset_password、vm_ready、invoice_paid、low_balance、topup_received、ticket_reply、scale_up …)とともに一覧表示されます。
- テンプレートをクリックし、言語を選択します。
- 件名と本文を編集します。プレースホルダーはメッセージがキューに入れられたときに値に置き換えられます。
- 保存します。変更は、その後キューに入れられるメッセージに直ちに適用されます。

制限と注意点
- 1つのインストールにつき1つのSMTPアカウントとなります。リセラーの顧客は、リセラーが個別に設定されていない限り、同じアカウントを通じてメールを受信します。
- プロバイダーの送信制限が適用されます。NexCMP側では再試行以外のスロットリングは行いません。
- SMTPなしでもパネルは機能しますが、顧客によるサインアップの確認やパスワードリセットを完了できません。
トラブルシューティング
| 症状 | 原因 | 対処法 |
|---|---|---|
| テストメールが届かない | 認証情報の誤り、ポートのブロック、送信者未承認 | journalctl -u nexcmp-vmd でSMTPエラーを確認し、STARTTLSを指定してポート587を試し、プロバイダー側でFromアドレスを確認してください。 |
| メッセージが迷惑メールフォルダに入る | SPF/DKIM/DMARCが未設定、または設定が不整合 | プロバイダーのレコードを公開し、そのドメインから送信してください。 |
| Sent emails で "failed" になっている | プロバイダーによってメッセージが拒否された | 行を開いてプロバイダーからの応答を確認してください。 |
| 保存後にパスワード欄が空に見える | 仕様上の動作です(書き込み専用) | パスワードが保存されると、ラベルに "current: set" と表示されます。 |