第三方邮件服务

通过第三方邮件服务，您可以为同一应用维护多个 SMTP 发信账户，并按收件人邮箱白名单或分流权重选择发件账户。该功能适用于注册激活码、登录验证码、重置密码验证码和多因素认证邮件等场景。

路径：登录 RootAuth 控制台 → 进入目标应用 → 点击顶部「配置」→「品牌化」→「电子邮件」→「第三方邮件服务」。

 

1. 功能概述

• 每个应用最多可保存 5 个 SMTP 配置。
• 您可以为不同 SMTP 配置设置分流权重，未命中邮箱白名单时，系统会按相对权重随机选择发件账户。
• 您可以为 SMTP 配置添加邮箱白名单。收件人命中白名单时，系统优先使用该 SMTP 发信，不参与分流权重选择。
• SMTP 配置的展示顺序不代表实际发信顺序。

 

2. 开启并管理 SMTP 配置

2.1 开启第三方邮件服务

「开启第三方服务」开关默认关闭。您可以先保存 SMTP 配置，但保存配置只会存储设置，不会自动启用第三方发信。

• 开启开关后：系统会按照本页的 SMTP 发送规则向应用用户发送邮件。
• 关闭开关后：所有邮件继续使用 RootAuth 默认域名发送；已保存的 SMTP 配置会保留，可在下次开启后继续维护。
• 关闭服务会移除当前未保存的新建配置，请先完成保存或取消编辑。

 

2.2 新建 SMTP 配置

点击「新建」后，在 SMTP 配置列表底部填写表单。已保存的配置数量会显示为「SMTP 配置 n/5」；达到 5 个后，不能继续新建。

字段	说明	是否必填
SMTP 地址	SMTP 服务器地址，例如 smtp.example.com。	是
端口	SMTP 服务器端口，默认 465。	是
用户名	SMTP 服务器登录用户名。	是
密码	SMTP 认证密码。	是
发件人邮箱	实际发送邮件时显示的发件人邮箱。	是
自定义名称	发件人显示名称，例如「RootAuth」。	否
分流权重	用于未命中白名单邮件的相对分流比例。	是
邮箱白名单	指定优先使用当前 SMTP 发信的收件人邮箱或邮箱域名。	否
安全验证	选择 SSL 或 TLS，默认 SSL。	是

2.3 测试并保存

1. 填写 SMTP 基础信息后，点击「测试配置并发送邮件」。
2. 测试成功后，点击「保存」完成当前 SMTP 配置。
3. 如果仅修改已保存配置的「分流权重」或「邮箱白名单」，可直接保存，无需重新测试；修改服务器、端口、账号或密码等基础信息后，需要重新测试成功才能保存。

未保存或配置不完整的 SMTP 账号不会参与实际邮件发送。

 

2.4 查看、编辑和删除

• 已保存配置按创建时间倒序显示，最新创建的配置位于最前。您可以展开卡片查看详情；展示顺序不代表发信优先级。
• 点击「编辑」可修改当前 SMTP 配置。同一时间仅能新建或编辑一条配置，请先保存或取消当前编辑后再操作其他配置。
• 开启第三方服务，仅有1个可用的SMTP配置则不允许删除，未开启或有多个时可删除不再使用的 SMTP 配置。删除时需要输入 DELETE 二次确认。

 

3. 分流权重

分流权重决定未命中邮箱白名单的邮件如何在多个 SMTP 账号之间分配。

• 分流权重为必填项，只能填写大于或等于 0 的数值，不设最大值。
• 各 SMTP 的权重不需要合计为 100；系统按各账号数值的相对比例进行随机选择。
• 权重为 0 的 SMTP 不参与普通的权重分流，但仍可发送命中其邮箱白名单的邮件。

例如，两个账号的权重分别为 1 和 3 时，未命中白名单的邮件会更倾向于由权重为 3 的账号发送。实际发送结果会随发送数量逐渐接近配置比例。

 

4. 邮箱白名单

邮箱白名单用于为特定收件人指定优先发信账户。白名单为可选配置，支持逐条添加和批量添加，单个 SMTP 最多可添加 100 条。

输入格式	匹配规则
user@example.com	完整邮箱匹配。仅当收件人邮箱与该值完全一致时命中。
@example.com	邮箱域名匹配。收件人邮箱域名为 example.com 时命中。

批量添加时，使用英文逗号分隔多个完整邮箱或以 @ 开头的邮箱域名。解析后，系统会将每项作为独立记录添加；格式不正确的记录需要修改后才能保存。

邮箱白名单的优先级高于分流权重。即使当前 SMTP 的分流权重为 0，命中其白名单的收件人仍会使用该 SMTP 发送邮件。

 

5. 邮件发送规则

1. 系统优先检查收件人是否命中已保存、配置完整的 SMTP 邮箱白名单。
2. 如果同一收件人命中多个 SMTP 的白名单，系统优先使用最早创建的 SMTP 配置发送。
3. 如果未命中任何白名单，系统从已保存、配置完整且分流权重大于 0 的 SMTP 账号中，按相对权重随机选择一个账号发送。
4. 随机选中或白名单命中的 SMTP 发送失败时，系统不会自动切换到其他 SMTP，本次邮件发送失败。

6. 与邮件模板的关系

邮件模板中的内容配置独立生效。启用第三方邮件服务后，实际使用的发件人邮箱由本页的白名单和分流权重规则决定；关闭第三方邮件服务后，系统统一使用 RootAuth 默认域名发送邮件。

 

7. 配置建议

• 在启用第三方邮件服务前，逐条测试 SMTP 配置，确认测试邮件可以正常送达。
• 为需要固定发件人的合作方、内部域名或重要收件人配置邮箱白名单。
• 为参与常规发送的 SMTP 设置大于 0 的分流权重，并定期检查各账号的可用性和发信额度。