Files
cloudflare_temp_email/vitepress-docs/docs/zh/guide/feature/subdomain.md
majorcheng 1a7cfb8c95 feat: 支持创建邮箱 API 的子域名后缀匹配开关 (#929)
* feat: 支持创建邮箱 API 的子域名后缀匹配开关

* fix: 修复 review 提到的开关三态与域名校验问题

* fix: 补充域名归一化与子域名匹配回归测试

* fix: 修复后台开关跟随 env 回退与 account_settings 半成功保存

* fix: 收口账号设置刷新提示与子域名状态重复读取

* fix: 拦截超长域名并透传账号设置刷新失败
2026-04-04 00:11:23 +08:00

2.0 KiB

配置子域名邮箱

::: warning 注意 子域名邮箱发送邮件可能无法发送邮件,建议使用主域名邮箱发送邮件,子域名邮箱仅用于接收邮件。

mail channel 已不被支持,下面参考中仅限收件部分。 :::

参考

创建随机二级域名地址

如果你已经配置好了基础域名的收件路由,还可以让用户在创建邮箱时,自动生成随机二级域名地址,例如:

  • 基础域名:abc.com
  • 创建结果:name@x7k2p9q1.abc.com

这适合做收件隔离、降低地址被重复命中的概率。

worker 变量中增加:

RANDOM_SUBDOMAIN_DOMAINS = ["abc.com"]
RANDOM_SUBDOMAIN_LENGTH = 8
  • RANDOM_SUBDOMAIN_DOMAINS:允许启用随机二级域名的基础域名列表
  • RANDOM_SUBDOMAIN_LENGTH:随机串长度,范围 1-63,默认 8

Note

这个功能只是在“创建地址”时自动补一个随机二级域名。

它不会自动帮你创建 Cloudflare 侧的子域名收件路由或 DNS 配置,请先确保基础域名/子域名路由本身已经可用。

允许 API 直接指定子域名

如果你不想让系统随机生成子域名,而是希望调用方在创建地址时直接指定 team.abc.com 这种子域名, 可以开启:

ENABLE_CREATE_ADDRESS_SUBDOMAIN_MATCH = true

开启后,只要允许域名里包含基础域名 abc.com,那么:

  • name@team.abc.com
  • name@dev.team.abc.com

都可以通过 /api/new_address/admin/new_address 创建。

Note

这个能力只放宽“创建地址 API 的域名校验”,不会改动默认域名下拉,也不会自动创建 Cloudflare 侧的 子域名邮箱路由。

如果你在管理后台里保存过这个开关,后续也可以通过“跟随环境变量”把它恢复到未设置状态,再重新回退到 env 默认值。