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

# 设置邮件

配置事务邮件服务、验证发件人，并预览每个模板。

## 安装与配置

在执行任何步骤之前，请阅读[开始之前](https://supastack.dev/zh/docs/web/before-you-start.md) 和[终端基础知识](https://supastack.dev/zh/docs/web/terminal-basics.md)。这些说明假设您在 VS Code 中打开了完整的 supastack monorepo；它的根 package.json 标记存储库根。在 pnpm 命令中，工作区包是应用程序或共享代码文件夹；在产品中，工作空间是团队的数据容器和安全边界。 corepack pnpm --filter ... 从 monorepo 选择一个包，同时从其根运行命令。如果您仅打开同步的移动或桌面文件夹，则它不包含 Web 后端、Docker 设置或根脚本：从此 monorepo 或可访问的托管服务器运行后端，并使用平台文件夹自己的脚本。环境变量是存储在本地 .env 文件或托管仪表板中的命名设置；更改后重新启动相关应用程序，并将服务器机密保留在 NEXT_PUBLIC_ 和 EXPO_PUBLIC_ 值之外。

1、打开apps/web/.env.local，设置EMAIL_PROVIDER=local进行开发； EMAIL_FROM 是模板使用的发件人标签。

2. 使用 corepack pnpm --filter @supastack/web dev 从存储库根启动 Web 应用程序，并使用测试地址触发一次登录或邀请流程。预期：应用程序会记录本地电子邮件结果，而无需联系真正的提供商。仅在验证其发件人域并限制测试收件人后，才能连接重新发送、SES 或其他服务。

EMAIL_PROVIDER=local 保持本地确定性交付。对于配置的生产交付，请查看重新发送或 SES 适配器并提供其服务器凭据。 EMAIL_FROM 必须与所选提供商验证的身份相符。

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

```
EMAIL_PROVIDER=local
EMAIL_FROM=supastack <hello@example.test>
# Production adapter configuration is listed in .env.example:
# RESEND_API_KEY=  POSTMARK_SERVER_TOKEN=  SENDGRID_API_KEY=  BREVO_API_KEY=
# MAILGUN_API_KEY=  MAILGUN_DOMAIN=  MAILGUN_REGION=us
```


## 要复制的命令

按照注释查看命令在哪个文件夹中运行。如果标记了两个终端，请打开两个终端窗口，并在使用第二个命令时保持第一个命令运行。

```
corepack pnpm --filter @supastack/web dev
```


## 实现流程

认证与完成消息走事务性邮件边界。营销触达属于使用方产品并保持分离。绝不要把这条路径复用为未经评审的群发子系统。

投递与生成分开记录。模型结果可用时，其完成消息可能失败。恢复应检查投递状态，而不是把同一结果再生成一遍。


## 验证与排障

如果没有出现本地电子邮件，请检查apps/web/.env.local中是否设置了EMAIL_PROVIDER并重新启动Web。如果真实提供商拒绝邮件，请确认 EMAIL_FROM 与经过验证的发件人匹配，并检查提供商的传送记录。即使后续电子邮件失败，生成的人工智能答案也能成功；再次运行 AI task 之前请检查交付情况。

在专用测试环境中验证收件人限制、发件身份与供应商错误。本地适配器结果不是真实邮件投递的证据。opt-in 冒烟路径通过 REAL_SMOKE_EMAIL_ALLOWED_DOMAIN 限制收件人。


如果你想继续完成设置，可以阅读《[设置 OAuth 登录](https://supastack.dev/zh/docs/web/setup-oauth.md)》。


## 下一篇

[事务性邮件](https://supastack.dev/zh/docs/modules/email.md)