feat: 支持 Cloudflare Temp Email 固定子域

docs/使用教程/使用教程.md

@@ -22,7 +22,7 @@
 |---|---|---|---|
 | 01 | 相关项目地址与部署说明 | `cpa`、`sub2api`、项目地址、部署前提、部署环境 | `docs/使用教程/分部分/01-相关项目地址与部署说明.md` |
 | 02 | 更新扩展 | `git pull`、`GitHub Desktop`、手动覆盖更新、扩展重新加载 | `docs/使用教程/分部分/02-更新扩展.md` |
-| 03 | Cloudflare Temp Email 使用说明 | `Cloudflare Temp Email`、`Admin Auth`、`Custom Auth`、随机子域、邮件接收 | `docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md` |
+| 03 | Cloudflare Temp Email 使用说明 | `Cloudflare Temp Email`、`Admin Auth`、`Custom Auth`、随机子域、固定子域、邮件接收 | `docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md` |
 | 04 | iCloud 隐私邮箱使用方法 | `iCloud+`、`隐藏邮件地址`、Apple ID、转发邮箱、刷新隐私邮箱 | `docs/使用教程/分部分/04-iCloud-隐私邮箱使用方法.md` |
 | 05 | QQ 邮箱切换邮箱使用教程 | `QQ 邮箱`、英文邮箱、`Foxmail`、删除后重建 | `docs/使用教程/分部分/05-QQ-邮箱切换邮箱使用教程.md` |
 | 06 | PayPal 注册与绑卡使用教程 | `PayPal`、注册、绑卡、钱包、身份认证、右上角通知 | `docs/使用教程/分部分/06-PayPal-注册与绑卡使用教程.md` |

docs/使用教程/使用教程书写模板.md

@@ -72,7 +72,7 @@ AI 维护时默认按下面的范围归类：
 |---|---|---|---|
 | 01 | 相关项目地址与部署说明 | `cpa`、`sub2api`、项目地址、部署前提、部署环境 | `docs/使用教程/分部分/01-相关项目地址与部署说明.md` |
 | 02 | 更新扩展 | `git pull`、`GitHub Desktop`、手动覆盖更新、扩展重新加载 | `docs/使用教程/分部分/02-更新扩展.md` |
-| 03 | Cloudflare Temp Email 使用说明 | `Cloudflare Temp Email`、`Admin Auth`、`Custom Auth`、随机子域、邮件接收 | `docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md` |
+| 03 | Cloudflare Temp Email 使用说明 | `Cloudflare Temp Email`、`Admin Auth`、`Custom Auth`、随机子域、固定子域、邮件接收 | `docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md` |
 | 04 | iCloud 隐私邮箱使用方法 | `iCloud+`、`隐藏邮件地址`、Apple ID、转发邮箱、刷新隐私邮箱 | `docs/使用教程/分部分/04-iCloud-隐私邮箱使用方法.md` |
 | 05 | QQ 邮箱切换邮箱使用教程 | `QQ 邮箱`、英文邮箱、`Foxmail`、删除后重建 | `docs/使用教程/分部分/05-QQ-邮箱切换邮箱使用教程.md` |
 | 06 | PayPal 注册与绑卡使用教程 | `PayPal`、注册、绑卡、钱包、身份认证、右上角通知 | `docs/使用教程/分部分/06-PayPal-注册与绑卡使用教程.md` |

docs/使用教程/分部分/03-Cloudflare-Temp-Email-使用说明.md

@@ -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 已经准备好