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/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 已接收邮件，不保证已送达收件箱。邮件配置概览

如果你想继续完成设置，可以阅读《收集其余提供商密钥》。