For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/web/aws-ses.md (or send Accept: text/markdown).

設定 Amazon SES 郵件

使用 AWS SDK 或 IAM SMTP 憑證為網頁、移動端和桌面端配置 Amazon SES，驗證發件人，並避免不必要的 Mail Manager 端點費用。

詢問本指南

1. 在所選 AWS 區域驗證發件人

在 US East (N. Virginia)，即 us-east-1，開啟 Amazon SES。選擇 Configuration → Identities → Create identity，選域名或郵箱並完成 DNS 或郵件驗證。下方設定使用同一區域和已驗證的發件人。

新 SES 賬戶預設處於沙盒：也要驗證收件人，或使用 SES 郵箱模擬器。向普通客戶傳送前，在 Account dashboard 申請生產訪問許可權。開啟 Amazon SES

2. SMTP 選擇 IAM SMTP credentials

在 SES 開啟 SMTP settings → Create SMTP credentials。選擇 IAM SMTP credentials，不選標為 Recommended 的 Mail Manager。IAM 卡片說明為 Manual credential management. No traffic policies or rule sets. 點選 Create IAM credentials，為傳送使用者命名，並在關閉頁面前下載 SMTP 憑證。

建立 IAM 憑證 · 管理現有使用者

這些連結使用支援傳統 IAM SMTP 的 us-east-1。使用其他受支援區域時，要建立該區域的憑證並使用對應 SMTP 端點。下載的 SMTP 密碼與 AWS 秘密訪問金鑰不同，只用於第 5 步。AWS SMTP 憑證說明

3. 避免不必要的 Mail Manager 費用

IAM SMTP 和 SES SDK 直接通過 SES 傳送，無需 Mail Manager 流量策略或規則集。避免建立可選的開放或 mTLS 入站端點：AWS 按需定價列出的費用為每個端點每月 50 美元。目前需要身份驗證的端點免費，因此 Recommended 選項並不一定增加 50 美元。正常傳送費用和所選定價方案仍然適用。檢視 AWS 當前定價

4. 使用 AWS SDK 傳送

此模式通過 HTTPS 使用 SES API。在 IAM 為後端角色或專用傳送使用者授予已驗證 SES 身份的 ses:SendEmail 許可權。使用者開啟 Security credentials → Create access key，儲存訪問金鑰 ID 和原始秘密訪問金鑰。SMTP 密碼不能用於簽署 SDK 請求。

開發時將示例放入 apps/web/.env.local，生產時放入後端託管平臺的金鑰設定，並替換髮件人和佔位值。使用 IAM 角色或配置好的本地 AWS 配置檔案時，將兩個金鑰欄位和 AWS_SESSION_TOKEN 留空，SDK 會使用預設憑證鏈。顯式填寫金鑰時必須同時提供兩個值。

顯式使用臨時憑證時，還需設定匹配的 AWS_SESSION_TOKEN，並在過期後更新全部三個值。角色憑證由 SDK 自動重新整理。AWS SDK 預設憑證鏈

EMAIL_PROVIDER=ses
EMAIL_FROM=Your App <[email protected]>
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=<IAM-access-key-id>
AWS_SECRET_ACCESS_KEY=<original-IAM-secret-access-key>
# Temporary explicit credentials only:
AWS_SESSION_TOKEN=

5. 或使用傳統 IAM SMTP

此替代配置使用第 2 步下載的 SMTP 使用者名稱和 SMTP 密碼。埠 587 使用 STARTTLS，SMTP_SECURE=false 選擇該連線模式。端點、憑證和已驗證發件人必須屬於同一區域。

這些是購買者模板的配置，三個平臺共用。每次選擇一種郵件模式：EMAIL_PROVIDER=smtp 使用 SMTP 憑證，EMAIL_PROVIDER=ses 使用 SDK API 憑證。

EMAIL_PROVIDER=smtp
EMAIL_FROM=Your App <[email protected]>
SMTP_HOST=email-smtp.us-east-1.amazonaws.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=<downloaded-SMTP-username>
SMTP_PASSWORD=<downloaded-SMTP-password>

6. 一次配置，適用於網頁、移動端和桌面端

修改配置後重啟後端。完成資料庫遷移後，在 /auth 向允許的收件人請求一封登入驗證碼，檢查收件箱和垃圾郵件。移動端呼叫同一後端，桌面端載入網頁應用。兩個客戶端都不需要 AWS 金鑰或 SMTP 密碼。

憑證僅儲存在後端，不能放入 NEXT_PUBLIC_、EXPO_PUBLIC_ 或桌面安裝包。傳送失敗時，檢查發件人驗證、沙盒收件人限制、區域、IAM 許可權和憑證型別。queued 僅表示 SES 已接收郵件，不保證已送達收件箱。郵件配置概覽