Files
Dream Hunter 46fbb4c099 docs: clarify Email Routing setup order (#1006)
docs: clarify email routing setup order
2026-04-25 21:35:14 +08:00

1.7 KiB

Cloudflare Email Routing

[!IMPORTANT] A domain is a hard prerequisite for deployment Mail reception in this project is entirely dependent on Cloudflare Email Routing. Before deploying Worker / Pages, you must already have:

  • A domain whose DNS is hosted on Cloudflare.
  • Email Routing enabled on that domain in the Cloudflare dashboard, with the Email DNS records provisioned.

After the Worker is deployed, you must also configure a Catch-all routing rule that delivers mail to that Worker. Without completing both phases, no inbound mail and no verification code will ever be received, even if the Worker / Pages deployment itself succeeds.

  1. In the CF console for the corresponding domain under Email Routing, configure the Email DNS records. If there are multiple domains, you need to configure Email DNS records for each domain.

  2. Before binding an email address to your Worker, you need to enable email routing and have at least one verified email address (destination address).

  3. Configure the Catch-all address in the routing rules of each domain's Email Routing to send to worker.

email

[!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, and a subdomain does not inherit its parent domain's Email Routing configuration — mail to a subdomain that has not been individually enabled will fail to deliver.