> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 设置 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](https://us-east-1.console.aws.amazon.com/ses/home?region=us-east-1)


## 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 凭证](https://us-east-1.console.aws.amazon.com/iam/home?SESRegion=us-east-1#/users/smtp/create) · [管理现有用户](https://us-east-1.console.aws.amazon.com/iam/home#/users)

这些链接使用支持传统 IAM SMTP 的 us-east-1。使用其他受支持区域时，要创建该区域的凭证并使用对应 SMTP 端点。下载的 SMTP 密码与 AWS 秘密访问密钥不同，只用于第 5 步。[AWS SMTP 凭证说明](https://docs.aws.amazon.com/ses/latest/dg/smtp-credentials.html)


## 3. 避免不必要的 Mail Manager 费用

IAM SMTP 和 SES SDK 直接通过 SES 发送，无需 Mail Manager 流量策略或规则集。避免创建可选的开放或 mTLS 入站端点：AWS 按需定价列出的费用为每个端点每月 50 美元。目前需要身份验证的端点免费，因此 Recommended 选项并不一定增加 50 美元。正常发送费用和所选定价方案仍然适用。[查看 AWS 当前定价](https://aws.amazon.com/ses/pricing/)


## 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 默认凭证链](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html)

```
EMAIL_PROVIDER=ses
EMAIL_FROM=Your App <hello@yourdomain.com>
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 <hello@yourdomain.com>
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 已接收邮件，不保证已送达收件箱。[邮件配置概览](https://supastack.dev/zh/docs/web/setup-email.md)


如果你想继续完成设置，可以阅读《[收集其余提供商密钥](https://supastack.dev/zh/docs/web/provider-keys.md)》。


## 下一篇

[收集其余提供商密钥](https://supastack.dev/zh/docs/web/provider-keys.md)