メールに戻る

コードで送信

任意の SMTP ライブラリを使用してアプリケーションからメールを送信します。 Node.js / nodemailer フローが最も一般的であるため、このフローを示します。他のすべての言語はまったく同じフィールドを使用します。

ノードメーラーをインストールする

terminal
npm install nodemailer
# or
pnpm add nodemailer
# or
bun add nodemailer

最小限のトランスポーター

mailer.ts
import nodemailer from "nodemailer";

export const transporter = nodemailer.createTransport({
  host: process.env.SMTP_HOST!,        // smtp host from the right rail
  port: Number(process.env.SMTP_PORT), // 587
  secure: false,                       // STARTTLS upgrades after connect
  requireTLS: true,                    // refuse if TLS upgrade is unavailable
  auth: {
    user: process.env.SMTP_USER!,      // your full email address
    pass: process.env.SMTP_PASS!,      // postmaster password - keep in .env
  },
});
なぜ 465 + secure: true ではなく 587 + STARTTLS をポートするのでしょうか? どちらも機能します。 587/STARTTLS は最新の提出標準であり、ほとんどのクライアントが選択します。 465 (暗黙的 TLS) もサポートされています - 設定 port: 465, secure: true そして削除します requireTLS.

メッセージを送信する

send.ts
import { transporter } from "./mailer";

await transporter.sendMail({
  from: '"Your App" <[email protected]>',
  to: "[email protected]",
  subject: "Hello from your self-hosted mail server",
  text: "Plain-text body.",
  html: "<p>HTML body too - clients pick whichever they prefer.</p>",
});

まず接続を確認してください

起動時にサーバーに ping を実行すると、最初の sendMail がタイムアウトするのを待たずに、壊れた設定がすぐに失敗します。

boot.ts
await transporter.verify();
console.log("SMTP ready");

他の言語から

ホスト、ポート、TLS モード、ユーザー名、パスワードなどの形状はライブラリ間で同一です。

python · smtplib
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "[email protected]"
msg["To"] = "[email protected]"
msg["Subject"] = "Hello"
msg.set_content("Plain text body")

with smtplib.SMTP("smtp.yourdomain.com", 587) as s:
    s.starttls()
    s.login("[email protected]", "PASSWORD")
    s.send_message(msg)
go · net/smtp
auth := smtp.PlainAuth("",
  "[email protected]",
  "PASSWORD",
  "smtp.yourdomain.com",
)
err := smtp.SendMail(
  "smtp.yourdomain.com:587",
  auth,
  "[email protected]",
  []string{"[email protected]"},
  []byte("Subject: Hello\r\n\r\nbody"),
)

製作チェックリスト

  1. 1
    決してパスワードをコミットしないでください。使用する 環境変数 実行時にロードされる (Vercel/Railway/Fly すべてがこれを実行します。ローカルで使用します) .env.local).
  2. 2
    シングルを維持する トランスポーター プロセスの存続期間中、インスタンスを維持します - 電子メールごとに新しい TCP+TLS ハンドシェイクを開くと、スループットが低下します。
  3. 3
    を設定します。 から このサーバー上に存在するメールボックスのアドレス。外部送信元アドレスは SPF + DMARC ポリシーによって拒否されます。
  4. 4
    トランザクション量については、次を実行します。 検証() 起動時に再試行を追加します メールを送信;一時的なネットワークのブリップは正常です。
  5. 5
    メールの送信が停止した場合は、OpenShip 管理画面の [ヘルス] タブを確認してください。そこに送信キューが存在します。