Skip to content

配置子域名邮箱

注意

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

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

参考

创建随机二级域名地址

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

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

worker 变量中增加:

toml
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 这种子域名, 可以开启:

toml
ENABLE_CREATE_ADDRESS_SUBDOMAIN_MATCH = true

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

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

NOTE

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

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

基于 MIT 许可发布