feat: 支持 Cloudflare Temp Email 固定子域

This commit is contained in:
qqqasdwx
2026-05-23 10:15:13 +00:00
parent 5f73c505a0
commit 7fe46cee31
18 changed files with 424 additions and 27 deletions
@@ -3,7 +3,7 @@
## 部分信息
- `section_slug`: `cloudflare-temp-email`
- `适用主题`: `Cloudflare Temp Email``Admin Auth``Custom Auth`、随机子域、邮件接收
- `适用主题`: `Cloudflare Temp Email``Admin Auth``Custom Auth`、随机子域、固定子域、邮件接收
- `维护方式`: `直接更新本文件`
## 适用场景
@@ -16,6 +16,7 @@
- 一个可用的 `Cloudflare Temp Email` 后端地址
- 如果要使用随机子域,对应域名解析已经提前配置好
- 如果要使用固定子域,后端已经开启 `ENABLE_CREATE_ADDRESS_SUBDOMAIN_MATCH`
- 后端的 `admin auth`
- 如果站点额外设置了访问密码,对应的访问认证信息
- 一个真正用于接收转发邮件的收件邮箱
@@ -52,23 +53,39 @@
### 第五步:配置 `Temp 域名`
这里填写允许创建邮箱的基础域名。
即使你开启了 `随机子域`,这里仍然填写基础域名,而不是随机出来的子域名。
这里选择允许创建邮箱的基础域名。
即使你开启了 `随机子域``固定子域`,这里仍然选择基础域名,而不是最终子域名。
### 第六步:按需开启 `随机子域`
只有在 `邮箱生成 = Cloudflare Temp Email` 时,这一项才会生效。
`随机子域``固定子域` 互斥,只能开启其中一个。
启用前需要先确认:
- 后端已经配置 `RANDOM_SUBDOMAIN_DOMAINS`
- Cloudflare DNS 已经设置 `MX *`
### 第七步:作为 `邮箱服务` 时填写 `邮件接收`
### 第七步:按需开启 `固定子域`
只有在 `邮箱生成 = Cloudflare Temp Email` 时,这一项才会生效。
开启 `固定子域` 后再填写 `子域前缀`,例如:
- `子域前缀 = a`
- `Temp 域名 = b.com`
- 最终提交给后端的域名是 `a.b.com`
切换 `Temp 域名` 后,子域前缀会继续复用。例如选择 `c.com` 后会生成 `xxx@a.c.com`
启用前需要先确认:
- 后端已经开启 `ENABLE_CREATE_ADDRESS_SUBDOMAIN_MATCH`
- 目标子域名的邮件解析已经准备好,或通配 MX 可以覆盖该子域
### 第八步:作为 `邮箱服务` 时填写 `邮件接收`
如果 `邮箱服务` 也选了 `Cloudflare Temp Email`,还需要填写真正的收件邮箱。
后续转发邮件会送到这里。
### 第步:查看后端搭建参考
### 第步:查看后端搭建参考
如果你还没有部署后端,可以参考:
@@ -88,8 +105,14 @@
通常是因为后端没有配置 `RANDOM_SUBDOMAIN_DOMAINS`,或者 Cloudflare DNS 没有完成 `MX *` 设置。
### 为什么固定子域没有生效?
通常是因为后端没有开启 `ENABLE_CREATE_ADDRESS_SUBDOMAIN_MATCH`,或者 `子域前缀` 不符合单段 DNS label 规则。
前缀只能使用小写字母、数字和中横线,不能包含点号、下划线,也不能以中横线开头或结尾。
## 注意事项
- 如果同时把它用作 `邮箱生成``邮箱服务`,要把两边相关字段都检查一遍
- `Custom Auth` 只有额外访问密码场景才需要填写
- 开启随机子域前,先确认后端和 DNS 已经准备好
- `随机子域``固定子域` 互斥,开启固定子域时会自动关闭随机子域
- 开启随机子域或固定子域前,先确认后端和 DNS 已经准备好