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/setup-email.md (or send Accept: text/markdown).

设置邮件

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

询问本指南

安装与配置

在执行任何步骤之前，请阅读开始之前和终端基础知识。这些说明假设您在 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

EMAIL_PROVIDER=local
EMAIL_FROM=supastack <[email protected]>
# 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 登录》。