本页由英文自动翻译。

阅读英文版
Proxy Mail QA

只在开发环境中让测试地址通过一次性邮箱拦截

拦截一次性地址能把虚假账号挡在线上应用之外,但也会挡住你自己的测试。解决办法不是关掉拦截,而是一份只存在于开发和预发布环境中的简短允许列表。

更新于

许多注册表单会拒绝以一次性邮件闻名的域名上的地址。这个检查可能是你代码里的一个列表、一个一次性域名列表之类的包、认证服务商的一项设置,或者表单调用的邮箱检查服务。Proxy Mail QA 的域名可能会出现在这些列表中,因为任何人都能在上面创建地址。

保留拦截,为测试环境添加允许列表

拦截在生产环境中是有用的。你需要的是一份跳过拦截的简短域名列表,从只有开发和预发布环境才设置的环境变量中读取:

// Read once at start-up. Unset in production, so the list is empty there.
const TEST_DOMAINS = (process.env.ALLOW_TEST_EMAIL_DOMAINS ?? '')
.split(',')
.map((domain) => domain.trim().toLowerCase())
.filter(Boolean);
export function isBlockedDomain(email: string, blocked: Set<string>): boolean {
const domain = email.split('@').pop()?.toLowerCase() ?? '';
if (TEST_DOMAINS.includes(domain)) return false;
return blocked.has(domain);
}

然后,只在开发和预发布环境中:

ALLOW_TEST_EMAIL_DOMAINS=mailclub.dev,enable.li,valida.te.it
  • 写明域名,而不是模式。 只允许你测试用的那几个域名,绝不要用 *.dev 或所有带点的域名。
  • 在服务器端读取。 只在浏览器中运行的检查,会被直接提交表单的人绕过,生产环境也一样。
  • 默认拒绝。 如果变量缺失,列表为空,拦截照常生效,这样缺少设置也不会让生产环境失守。

如果拦截在你调用的服务中

邮箱检查服务和认证服务商通常有自己的允许列表。如果服务商区分不同环境,只在开发或预发布项目中添加我们的域名。如果一个设置覆盖所有环境,就在开发和预发布环境中关闭该服务的检查、在生产环境中开启,或在上面的环境变量列出该域名时跳过调用。

检查用户看到的内容

顺便测试一下拦截本身:

  • 被拦截域名上的地址会被拒绝,并显示告诉用户该怎么做的提示(“请使用你的工作或个人邮箱地址”),而不是笼统的错误。
  • 拒绝发生在账号创建之前,所以不会留下创建了一半的用户。
  • 真人带 + 标签的地址(name+news@example.org)仍能通过,除非你决定也拒绝这类地址。

关于表单自身的校验,少见但有效的地址涵盖了大写字母、+ 标签和三段式域名。

在你的下一次注册测试中试试

免费版,无需信用卡。创建一个地址,看着验证码或链接送达。

免费创建账号打开应用

常见问题

Proxy Mail QA 地址使用哪些域名?

mailclub.dev、enable.li 和 valida.te.it。项目在 Project settings 中选择其中一个作为邮件域名,Add account 中的域名选择器可以为单个地址更改它。

生产环境也应该允许这些域名吗?

不应该。Proxy Mail QA 用于应用的开发、预发布和预览版本。不要把允许列表放进生产环境设置,让线上应用像对待其他一次性域名一样对待我们的域名。

我的表单还没查列表就拒绝了这个地址。为什么?

有些表单检查的是地址的格式而不是域名:它们会拒绝 + 标签、包含多个点的域名,或不认识的域名。先试试 mailclub.dev 上的地址;如果也被拒绝,问题出在表单的校验,而不是拦截列表。

我能测试拦截是否仍然有效吗?

可以。开启允许列表后,用一个不在你列表中的已知一次性域名地址注册:表单应拒绝它,并显示清楚的提示。请使用不接收邮件的域名,以免邮件发到陌生人那里。

你的应用是用 AI 工具构建的?选择你的工具

对本页有疑问?

可以用任何语言提问。文档可以立即回答,你也可以把问题发给 Proxy Mail QA 团队,他们会用英文回复。