导航|地址|刷新
Custom Domains

Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.

Docs Directory API SDKs Changelog

Search

Log in

Workers

/

Overview

Getting started

CLI

Dashboard

Prompting

Templates

Examples

Tutorials

Best practices

Workers Best Practices

Demos and architectures

Overview

Build an Interactive ChatGPT App

Local development

Overview

Environment variables and secrets

Vite Plugin ↗

Choosing between Wrangler & Vite

Developing with multiple Workers

Adding local data

Supported bindings per development mode

Local Explorer

Share a local dev server

Playground

Configuration

Overview

Workers Sites

Overview

Start from existing

Start from scratch

Start from Worker

Workers Sites configuration

Bindings ↗

Compatibility dates

Compatibility flags

Cron Triggers

Environment variables

Integrations

Overview

APIs

External Services

Multipart upload metadata

Page Rules

PlacementBeta

Routes and domains

Overview

Custom Domains

Routes

workers.dev

Secrets

Versions & deployments

Overview

Deployment management

Preview URLs

Gradual deployments

Overview

Version affinity

With Durable Objects

Version overrides

Rollbacks

CI/CD

Overview

Builds

Overview

Configuration

Automatic pull requests

Git integration

Overview

GitHub integration

GitLab integration

Build image

Build caching

Build branches

Build watch paths

Deploy Hooks

Advanced setups

Event subscriptions

Troubleshooting builds

Builds API reference

Limits & pricing

MCP serverMCP

External CI/CD

Overview

GitHub Actions

GitLab CI/CD

Workers Cache

Overview

Configuration

Cache keys

Purging the cache

Examples

Debugging

Limitations

Runtime APIs

Overview

Remote-procedure call (RPC)

Overview

Lifecycle

Reserved Methods

Visibility and Security Model

TypeScript

Error handling

WebAssembly (Wasm)

Overview

Wasm in JavaScript

Bindings (env)

Overview

AI ↗

Analytics Engine ↗

Assets ↗

Browser Run ↗

D1 ↗

Dispatcher (Workers for Platforms) ↗

Durable Objects ↗

Dynamic Worker Loaders

Environment Variables ↗

Hyperdrive ↗

Images ↗

KV ↗

Media Transformations ↗

mTLS

Queues ↗

R2 ↗

Rate Limiting

Secrets ↗

Secrets Store ↗Beta

Service bindings

Overview

HTTP

RPC (WorkerEntrypoint)

Stream ↗

Vectorize ↗

Version metadataBeta

Workflows ↗

Cache

Console

Context (ctx)

Encoding

EventSource

Fetch

Handlers

Overview

Alarm Handler ↗

Email Handler ↗

Fetch Handler

Queue Handler ↗

Scheduled Handler

Tail Handler

Headers

HTMLRewriter

MessageChannel

Node.js compatibility

Overview

assert

AsyncLocalStorage

Buffer

crypto

Diagnostics Channel

dns

EventEmitter

fs

http

https

net

path

process

Streams

StringDecoder

test

timers

tls

url

util

zlib

Performance and timers

Request

Response

Scheduler

Streams

Overview

ReadableStream

ReadableStream BYOBReader

ReadableStream DefaultReader

TransformStream

WritableStream

WritableStream DefaultWriter

TCP sockets

Web Crypto

Web standards

WebSockets

Static Assets

Overview

Get Started

Configuration and Bindings

Routing

Full-stack application

Single Page Application (SPA)

Static Site Generation (SSG) and custom 404 pages

Worker script

Advanced

Gradual rollouts ↗

HTML handling

Serving a subdirectory

Headers

Redirects

Direct Uploads

Billing and Limitations

Migration Guides

Migrate from Pages to Workers

Migrate from Netlify to Workers

Migrate from Vercel to Workers

Framework guides

Deploy an existing project

Web applications

React + Vite

Astro

React Router (formerly Remix)

Next.js

Vue

RedwoodSDK

TanStack Start

Microfrontends

SvelteKit

Vike

More guides...

Analog

Angular

Docusaurus

Gatsby

Hono

Nuxt

Qwik

SolidBeta

Waku

Mobile applications

Expo

APIs

FastAPI ↗

Hono ↗

AI & agents

Agents SDK ↗

LangChain ↗

Databases

Connect to databases

Analytics Engine ↗

Vectorize (vector database) ↗

Cloudflare D1 ↗

Hyperdrive ↗

3rd Party Integrations

Overview

Neon

PlanetScale

Supabase

Turso

Upstash

Xata

Testing

Overview

Vitest integration

Overview

Write your first test

Recipes and examples

Configuration

Test APIs

Isolation and concurrency

Debugging

Known issues

Migration guides

Migrate from Vitest 3 to Vitest 4

Migrate from Miniflare 2's test environments

Migrate from unstable_dev

Integration test harness

Overview

Get started

Configure the test harness

Prepare test state

Interact with Workers

Integrations

Miniflare

Overview

Get Started

Writing tests

Core

Compatibility Dates

Fetch Events

Modules

Multiple Workers

Queues

Scheduled Events

Variables and Secrets

Web Standards

WebSockets

Developing

Attaching a Debugger

Live Reload

Migrations

Migrating from Version 2

Storage

Cache

D1

Durable Objects

KV

R2

Wrangler's unstable_startWorker()

Observability

Overview

Metrics and analytics

Logs

Overview

Workers Logs

Real-time logs

Tail Workers

Workers Logpush

TracesBeta

Overview

Custom spansBeta

Spans and attributes

Known limitations

DevTools

Overview

Breakpoints

Profiling CPU usage

Profiling Memory

Query Builder

Exporting OpenTelemetry Data

Overview

Export to Honeycomb

Export to Grafana Cloud

Export to Axiom

Export to Sentry

Export to PostHog

MCP serverMCP

Errors and exceptions

Integrations

Sentry

Source maps and stack traces

Wrangler

Overview

Install/Update Wrangler

Migrations

Migrate from Wrangler v3 to v4

Migrate from Wrangler v2 to v3

Migrate from Wrangler v1 to v2

Wrangler v1 (legacy)

Overview

Install / Update

Authentication

Commands

Configuration

Webpack

1. Migrate webpack projects

2. Update to Wrangler v2

API

Commands

Overview

Workers

General commands

Artifacts

Browser

Certificates

Containers

D1

Flagship

Hyperdrive

KV

Pages

Pipelines

Queues

R2

Secrets Store

Tunnel

Vectorize

VPC

Workers for Platforms

Workflows

Authentication profiles

Bundling

Configuration

Custom builds

Deprecations

Environments

System environment variables

Vite plugin

Overview

Get started

Tutorial - React SPA with an API

Reference

API

Static Assets

Debugging

Migrating from wrangler dev

Secrets

Vite Environments

Cloudflare Environments

Non-JavaScript modules

Programmatic configuration

Languages

Overview

JavaScript

Overview

Examples ↗

TypeScript

Overview

Examples ↗

Python WorkersBeta

Overview

The Basics

How Python Workers Work

Foreign Function Interface (FFI)

Standard Library

Examples

Packages

Overview

FastAPI

Langchain

RustBeta

Overview

Supported crates

Platform

Overview

Pricing

Changelog

Overview

Workers (Historic)

Wrangler

Limits

Choose a data or storage product

Betas

Deploy to Cloudflare buttons

Claim deployments (temporary accounts)

Built with Cloudflare button

Known issues

Workers for Platforms ↗

Infrastructure as Code (IaC)

Glossary

Reference

How the Cache works

How Workers works

Migrate from Service Workers to ES Modules

Protocols

Security model

Agent resources

Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

Workers llms.txt ↗

Workers llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗

Home

/Workers

/…
Configuration

/Routes and domains

/Custom Domains

Custom Domains

Last updated Jun 23, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewBackgroundAdd a Custom Domain Set up a Custom Domain in the dashboard Set up a Custom Domain in your Wrangler configuration fileWorker to Worker communicationRequest matching behaviourInteraction with RoutesCertificatesRedirect between www and root domainMigrate from Routes Migrate from Routes via the dashboard Migrate from Routes via Wrangler

Background

Custom Domains allow you to connect your Worker to a domain or subdomain, without having to make changes to your DNS settings or perform any certificate management. After you set up a Custom Domain for your Worker, Cloudflare will create DNS records and issue necessary certificates on your behalf. The created DNS records will point directly to your Worker. Unlike Routes, Custom Domains point all paths of a domain or subdomain to your Worker.

Custom Domains are routes to a domain or subdomain (such as example.com or shop.example.com) within a Cloudflare zone where the Worker is the origin.

Custom Domains are recommended if you want to connect your Worker to the Internet and do not have an application server that you want to always communicate with. If you do have external dependencies, you can create a Request object with the target URI, and use fetch() to reach out.

Custom Domains can stack on top of each other. For example, if you have Worker A attached to app.example.com and Worker B attached to api.example.com, Worker A can call fetch() on api.example.com and invoke Worker B.

Custom Domains can also be invoked within the same zone via fetch(), unlike Routes.

Add a Custom Domain

To add a Custom Domain, you must have:

An active Cloudflare zone.

A Worker to invoke.

Custom Domains can be attached to your Worker via the Cloudflare dashboard, Wrangler or the API.

Caution

You cannot create a Custom Domain on a hostname with an existing CNAME DNS record or on a zone you do not own.

Set up a Custom Domain in the dashboard

To set up a Custom Domain in the dashboard:

In the Cloudflare dashboard, go to the Workers & Pages page.
Go to Workers & Pages ↗

In Overview, select your Worker.

Go to Settings > Domains & Routes > Add > Custom Domain.

Enter the domain you want to configure for your Worker.

Select Add Custom Domain.

After you have added the domain or subdomain, Cloudflare will create a new DNS record for you. You can add multiple Custom Domains.

Set up a Custom Domain in your Wrangler configuration file

To configure a Custom Domain in your Wrangler configuration file, add the custom_domain=true option on each pattern under routes. For example, to configure a Custom Domain:

{ "routes": [ { "pattern": "shop.example.com", "custom_domain": true } ]}

[[routes]]pattern = "shop.example.com"custom_domain = true

To configure multiple Custom Domains:

{ "routes": [ { "pattern": "shop.example.com", "custom_domain": true }, { "pattern": "shop-two.example.com", "custom_domain": true } ]}

[[routes]]pattern = "shop.example.com"custom_domain = true[[routes]]pattern = "shop-two.example.com"custom_domain = true

Worker to Worker communication
…(内容过长已截断)

------
导航页打开网址