From 1584851a360e4ba09d5666953f7b6ed3169675ae Mon Sep 17 00:00:00 2001 From: Dream Hunter Date: Sat, 11 Apr 2026 16:32:20 +0800 Subject: [PATCH] docs: note that subdomains need Email Routing enabled separately (#970) Subdomains do not inherit Email Routing from the apex domain; each subdomain must enable Email Routing and configure its own DNS records and Catch-all rule. Refs #969 Co-authored-by: Claude Opus 4.6 --- CHANGELOG.md | 1 + CHANGELOG_EN.md | 1 + vitepress-docs/docs/en/guide/common-issues.md | 1 + vitepress-docs/docs/en/guide/email-routing.md | 3 +++ vitepress-docs/docs/zh/guide/common-issues.md | 1 + vitepress-docs/docs/zh/guide/email-routing.md | 3 +++ 6 files changed, 10 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index c6184e3c..a379145d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -25,6 +25,7 @@ - docs: |侧边栏| 重组文档侧边栏结构，拆分为"核心配置"、"通知与集成"、"高级功能"、"管理后台"等分组 - docs: |FAQ| 大幅扩充常见问题，新增 SPA 404、发信余额、SMTP_CONFIG 配置、邮件客户端登录等高频问题（#919, #925, #839, #715, #921, #609） - docs: |发送邮件| 增强 SMTP_CONFIG 字段说明和多域名示例，新增发信余额机制说明 +- docs: |Email Routing| 补充子域名需单独启用 Email Routing 的说明，避免仅在一级域名开启导致子域收不到邮件（#969） ## v1.5.0(main) diff --git a/CHANGELOG_EN.md b/CHANGELOG_EN.md index 4ff3c03f..6f66113e 100644 --- a/CHANGELOG_EN.md +++ b/CHANGELOG_EN.md @@ -25,6 +25,7 @@ - docs: |Sidebar| Restructure documentation sidebar into "Core Configuration", "Notifications & Integrations", "Advanced Features", "Admin Console" groups - docs: |FAQ| Significantly expand FAQ with SPA 404, send balance, SMTP_CONFIG, mail client login and more (#919, #925, #839, #715, #921, #609) - docs: |Email Sending| Enhance SMTP_CONFIG field reference and multi-domain examples, add send balance mechanism documentation +- docs: |Email Routing| Note that subdomains require Email Routing to be enabled separately; enabling it only on the apex domain does not cover subdomains (#969) ## v1.5.0(main) diff --git a/vitepress-docs/docs/en/guide/common-issues.md b/vitepress-docs/docs/en/guide/common-issues.md index 0f0fda15..2ee309bf 100644 --- a/vitepress-docs/docs/en/guide/common-issues.md +++ b/vitepress-docs/docs/en/guide/common-issues.md @@ -9,6 +9,7 @@ | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | | Sending emails to authenticated forwarding addresses using Cloudflare Workers | Use CF's API for sending, only supports recipient addresses bound to CF, i.e., CF EMAIL forwarding destination addresses | | Binding multiple domains | Each domain needs to configure email forwarding to worker | +| Subdomain cannot receive email | Subdomains must have Email Routing **enabled separately** on Cloudflare with their own DNS records and Catch-all rule. Enabling it only on the apex domain does NOT cover subdomains. See [Email Routing](/en/guide/email-routing) | ## Worker Related diff --git a/vitepress-docs/docs/en/guide/email-routing.md b/vitepress-docs/docs/en/guide/email-routing.md index 462da61d..ef7a576b 100644 --- a/vitepress-docs/docs/en/guide/email-routing.md +++ b/vitepress-docs/docs/en/guide/email-routing.md @@ -7,3 +7,6 @@ 3. Configure the `Catch-all address` in the routing rules of each domain's `Email Routing` to send to `worker`. ![email](/readme_assets/email.png) + +> [!WARNING] Subdomains must be configured separately +> If you want to receive mail on a **subdomain** (e.g. `mail.example.com`), you must enable `Email Routing` on **that subdomain** in the CF dashboard and configure its email DNS records and Catch-all rule separately. Enabling Email Routing only on the apex domain **does not cover subdomains**. diff --git a/vitepress-docs/docs/zh/guide/common-issues.md b/vitepress-docs/docs/zh/guide/common-issues.md index 38ab78dd..bcdacd95 100644 --- a/vitepress-docs/docs/zh/guide/common-issues.md +++ b/vitepress-docs/docs/zh/guide/common-issues.md @@ -9,6 +9,7 @@ | -------------------------------------------------- | ------------------------------------------------------------------------------- | | 使用 Cloudflare Workers 给已认证的转发邮箱发送邮件 | 使用 cf 的 API 进行发送，只支持绑定到 CF 上的收件地址，即 CF EMAIL 转发目的地址 | | 绑定多个域名 | 每个域名都需要设置 email 转发到 worker | +| 子域名收不到邮件 | 子域名需要在 CF 上**单独启用** Email Routing 并配置 DNS 与 Catch-all 规则，仅在一级域开启不会自动覆盖子域，详见 [Email Routing](/zh/guide/email-routing) | ## Worker 相关 diff --git a/vitepress-docs/docs/zh/guide/email-routing.md b/vitepress-docs/docs/zh/guide/email-routing.md index c639f8f1..aa5366f3 100644 --- a/vitepress-docs/docs/zh/guide/email-routing.md +++ b/vitepress-docs/docs/zh/guide/email-routing.md @@ -7,3 +7,6 @@ 3. 配置每个域名的 `Email Routing` 的路由规则中的 `Catch-all 地址` 发送到 `worker` ![email](/readme_assets/email.png) + +> [!WARNING] 子域需要单独配置 +> 如果你要用**子域名**（如 `mail.example.com`）收信，必须在 CF 控制台里对 **该子域** 单独启用 `Email Routing`，并配置邮件 DNS 记录与 Catch-all 规则。仅在一级域名上开启 Email Routing **不会自动覆盖子域名**。