Dream Hunter
a3c62de42f
* feat: allow custom subdomains in create UI * test: stabilize custom subdomain browser flow * test: fix normalized address expectation * fix: gate custom subdomain input by setting * fix: scope custom subdomains to random domains * test: recreate random subdomain manually * refactor: minimize custom subdomain changes * refactor: reduce custom subdomain changes * test: fix custom subdomain locator * refactor: clarify manual subdomain validation * test: target visible custom subdomain input * refactor: simplify manual subdomain validation * refactor: use subdomain mode selector * style: stack subdomain modes vertically * test: click visible subdomain mode labels
4.2 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
创建地址 API 需要显式传入 enableRandomSubdomain: true 才会生成随机二级域名。前端勾选“启用随机二级域名”时会自动传这个字段；如果你自己调用 /api/new_address 或 /admin/new_address，也需要在请求体中传入：
{
"name": "test",
"domain": "abc.com",
"enableRandomSubdomain": true
}
domain 必须传 RANDOM_SUBDOMAIN_DOMAINS 中配置的基础域名，例如 abc.com。如果要创建 team.abc.com 这种指定子域名地址，请不要传 enableRandomSubdomain: true，而是使用下方“直接指定子域名”的流程。
对于 RANDOM_SUBDOMAIN_DOMAINS 中的基础域名，网页端和管理后台会提供“普通域名”、
“启用随机子域名”和“使用自定义子域名”三种单选模式。自定义模式只需输入 team，前端会组合成 team.abc.com。
Note
这个功能只是在“创建地址”时自动补一个随机二级域名。
当前没有“全局强制随机二级域名”的后端开关；未传
enableRandomSubdomain: true的 API 调用不会自动随机。
[!IMPORTANT] 随机子域名需要 DNS 通配 MX 记录 程序只负责生成
name@<random>.abc.com这样的地址，能不能收到邮件完全取决于 DNS / Email Routing 是否覆盖到*.abc.com；Cloudflare Email Routing 的子域名配置不会从基础域名继承。可参考 Cloudflare 的 Email Routing — Subdomains 文档。让
*.abc.com可投递有两种做法：
- DNS 通配 MX 记录（最简方案） — 在
abc.com的 DNS 中，把基础域名上现有的每一条 MX 记录都复制一份到*主机名上，保留每条记录的 priority 与 target。这样*.abc.com会解析到与 apex 相同的 MX 目标，邮件流向同一个 Cloudflare Email Routing zone，并由 apex 的 Catch-all 规则交给 Worker，Cloudflare 侧不需要额外配置。- Cloudflare 控制台 “Add subdomain” — 在 Email Routing 后台显式添加该子域名，并单独配置其 DNS 与 Catch-all 路由规则。这只覆盖你添加的那个具体子域名，不适合随机生成的任意子域名。
随机子域名场景下推荐使用 方案 (1)。如果不做这一步，随机子域名功能在前端看起来正常，但实际邮件不会进入 Worker。
参考 issue：#1035
允许 API 直接指定其他子域名
如果基础域名不在 RANDOM_SUBDOMAIN_DOMAINS 中，但仍希望 API 调用方直接指定
team.abc.com 这种子域名，可以开启：
ENABLE_CREATE_ADDRESS_SUBDOMAIN_MATCH = true
开启后，只要允许域名里包含基础域名 abc.com，那么：
name@team.abc.comname@dev.team.abc.com
都可以通过 /api/new_address 或 /admin/new_address 创建。
Note
这个开关只放宽创建地址 API 的域名校验，不会改动前端的域名范围，也不会自动创建 Cloudflare 侧的子域名邮箱路由。
如果你在管理后台里保存过这个开关，后续也可以通过“跟随环境变量”把它恢复到未设置状态，再重新回退到 env 默认值。