Routes and domains
To allow a Worker to receive inbound HTTP requests, you must connect it to an external endpoint such that it can be accessed by the Internet.
There are three types of routes:
-
Custom Domains: Routes to a domain or subdomain (such as
example.com
orshop.example.com
) within a Cloudflare zone where the Worker is the origin. -
Routes: Routes that are set within a Cloudflare zone where your origin server, if you have one, is behind a Worker that the Worker can communicate with.
-
workers.dev
: Aworkers.dev
subdomain route is automatically created for each Worker to help you getting started quickly. You may choose to disable yourworkers.dev
subdomain.
It's recommended to run production Workers on a Workers route or custom domain, rather than on your workers.dev
subdomain. Your workers.dev
subdomain is treated as a Free website ↗ and is intended for personal or hobby projects that aren't business-critical.
Custom Domains are recommended for use cases where your Worker is your application's origin server. Custom Domains can also be invoked within the same zone via fetch()
, unlike Routes.
Routes are recommended for use cases where your application's origin server is external to Cloudflare. Note that Routes cannot be the target of a same-zone fetch()
call.