> ## 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

# 电子邮件

事务模板、预览工具与提供商适配器。

## 阅读您的第一条本地消息，然后启用传送

事务性电子邮件是指由应用程序操作触发的消息，例如登录代码或任务结果。 Web 服务器运行时，将 EMAIL_PROVIDER=local 保留在 apps/web/.env.local. 中 完成数据库设置，在 /auth 请求登录代码，然后打开 /mail-preview 并检查最新消息。此处显示的本地消息不是发送到您的外部收件箱的电子邮件。

要发送真实消息，请选择一个电子邮件提供商，创建其帐户，验证您控制的域并遵循其专用指南。将名为API的密钥和发件人地址放入apps/web/.env.local中，保存并重新启动Web服务器。请求一个新的登录代码，然后检查提供商的传送日志和目标收件箱，包括垃圾邮件。域验证和发件人批准可能需要时间。

如果消息失败，请在重复请求之前检查传送错误和发件人验证。 /mail-preview 路由仅用于开发，在生产中返回 404。将营销推广活动与该交易发件人分开，以便时事通讯活动不会中断帐户验证邮件。

[选择邮件提供商和发件人地址](https://supastack.dev/zh/docs/modules/email-configuration.md)

[启用重新发送传送](https://supastack.dev/zh/docs/web/setup-email.md)

[使用 AWS SDK 或 IAM SMTP 配置 Amazon SES](https://supastack.dev/zh/docs/web/aws-ses.md)


## 让事务性投递保持独立

邮件模块处理事务性产品消息，包括认证与任务完成通知。营销触达属于使用方产品自己的工作流，必须与这条事务性路径保持分离。


## 配置投递适配器

确定性测试用本地适配器。启用外部投递前，配置选定的生产适配器及其服务端凭证。绝不要把邮件供应商密钥放进客户端配置或日志。


## 独立记录投递结果

生成的结果与它的完成邮件是两个独立结果。在声称消息发送成功之前检查投递记录。测试投递失败时，不要把它当作生成失败，也不要重复提交模型工作。


## 安装与配置

EMAIL_PROVIDER=local 让开发期间的投递保持确定性。生产投递从已配置的适配器中选一个 —— Resend（RESEND_API_KEY）、AWS SES（AWS_REGION 加访问密钥）、Postmark、SendGrid、Mailgun、通用 SMTP 或 Brevo —— 并确认 EMAIL_FROM 与该供应商认可的发件身份一致。

所有模板位于 src/transactional-mail-templates.ts。仅开发可用的 /mail-preview 路由会渲染每个模板，让改动通过可视化审查，而不是靠真实发信。

```
EMAIL_PROVIDER=resend
EMAIL_FROM=Your Product <hello@yourdomain.com>
```


## 实现流程

认证代码、魔法链接、邀请、计费通知和任务完成邮件都通过同一个事务发送者,以已解析语言环境的文本发送。外展活动是独立的产品关注点,永远不会共享此路径。

在编辑文本或布局之前先在 mail-preview 中预览模板;让品牌值(名称、颜色、徽标拼块)来自配置,这样衍生产品可以在不 fork 模板的情况下重新设计样式。


## 验证与排障

在测试中对本地适配器记录的消息进行断言 —— 收件人、主题和渲染后的正文。发送失败应表现为投递结果,而不是崩溃的工作流。使用带 REAL_SMOKE_EMAIL_ALLOWED_DOMAIN 的可选 smoke 路径进行真实投递。


## 下一篇

[通知](https://supastack.dev/zh/docs/web/notifications.md)