← Cloudflare Workers / workers / configuration / routing

Custom Domains

Custom Domains umožňují připojit váš Worker k doméně nebo subdoméně, aniž byste museli měnit nastavení DNS nebo spravovat certifikáty. Po nastavení Custom Domain pro váš Worker Cloudflare vytvoří záznamy DNS a vystaví za vás potřebné certifikáty. Vytvořené záznamy DNS budou směřovat přímo na váš Worker. Na rozdíl od Trasy, Custom Domains směrují všechny cesty domény nebo subdomény na váš Worker.

Custom Domains jsou trasy k doméně nebo subdoméně (například example.com nebo shop.example.com) v rámci zóny Cloudflare, kde je Worker origin serverem.

Custom Domains se doporučují, pokud chcete připojit svůj Worker k internetu a nemáte aplikační server, se kterým chcete komunikovat trvale. Pokud externí závislosti máte, můžete vytvořit Request objekt s cílovým URI a použijte fetch() abyste se nám ozvali.

Custom Domains lze skládat na sebe. Pokud máte například Worker A připojený k app.example.com a Worker B připojený k api.example.com, Worker A může volat fetch() na api.example.com a vyvolejte Worker B.

Custom Domains lze také volat v rámci stejné zóny pomocí fetch(), na rozdíl od Routes.

Chcete-li přidat Custom Domain, musíte mít:

1. aktivní zóna Cloudflare.
2. Worker, který se má vyvolat.

Custom Domains lze k vašemu Workeru připojit prostřednictvím Cloudflare dashboardu, Wrangler nebo API.

Chcete-li v dashboardu nastavit Custom Domain:

Jakmile přidáte doménu nebo subdoménu, Cloudflare za vás vytvoří nový záznam DNS. Můžete přidat více Custom Domains.

Chcete-li vyžadovat, aby se návštěvníci před přístupem k vlastní doméně (Custom Domain) přihlásili, použijte Cloudflare Access.

Custom Domain můžete chránit pomocí Access založeného na hostname, nebo chránit přímo Worker napříč jeho Routes, Custom Domains, workers.dev hostname a náhledy. Více informací najdete v Cloudflare Access.

Chcete-li nakonfigurovat Custom Domain ve svém Konfigurační soubor Wrangler, přidejte custom_domain=true možnost u každého vzoru v routes. Chcete-li například nakonfigurovat Custom Domain:

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

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

Chcete-li nakonfigurovat více 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

Ve stejné zóně je jediným způsobem, jak může Worker komunikovat s jiným Workerem běžícím na trasa, nebo na workers.dev subdoména, je přes service bindings.

Pokud se Worker ve stejné zóně pokouší komunikovat s cílovým Workerem běžícím na Custom Domain namísto route, omezení se neuplatní. Požadavky fetch odeslané ve stejné zóně z jednoho Workeru na jiný Worker běžící na Custom Domain uspějí i bez service bindingu.

Uvažujme například následující scénář, kdy oba Workery běží na example.com zóna Cloudflare:

• worker-a běžící na trasa auth.example.com/*.
• worker-b běžící na trasa shop.example.com/*.

Pokud worker-a odešle fetch požadavek na worker-b, požadavek selže kvůli omezení pro fetch požadavky v rámci stejné zóny. worker-a musí mít vazbu na službu k worker-b než se tento požadavek vyřídí.

export default {
	fetch(request) {
		// This will fail
		return fetch("https://shop.example.com");
	},
};

Pokud však worker-b byl místo toho nastaven, aby běžel na Custom Domain shop.example.com, požadavek fetch by byl úspěšný.

Custom Domains nepodporují zástupné záznamy DNS. Příchozí požadavek musí přesně odpovídat doméně nebo subdoméně, na kterou je vaše Custom Domain zaregistrována. Ostatní části adresy URL (cesta, parametry dotazu) se při tomto porovnávání neberou v úvahu. Pokud například vytvoříte Custom Domain na api.example.com připojený k vašemu api-gateway Worker, požadavek na kterýkoli z api.example.com/login nebo api.example.com/user by vyvolalo stejný api-gateway Worker.

Worker běžící na Custom Domain je považován za origin. Workery běžící na routách před vaší Custom Domain mohou volitelně volat Worker zaregistrovaný na vaší Custom Domain vydáním fetch(request) s příchozím Request objekt. To znamená, že můžete nastavit Workery tak, aby se spustily dříve, než požadavek dorazí k vašemu Custom Domain Workeru. Jinými slovy můžete v rámci jednoho požadavku zřetězit dva Workery za sebou.

Uvažujme například následující workflow:

1. Custom Domain pro api.example.com odkazuje na váš api-worker Worker.
2. Route přidaná do api.example.com/auth odkazuje na váš auth-worker Worker.
3. Požadavek na api.example.com/auth spustí váš auth-worker Worker.
4. Použití fetch(request) v rámci auth-worker Worker vyvolá api-worker Worker, jako by šlo o běžný aplikační server.

export default {
	fetch(request) {
		const url = new URL(request.url);
		if (url.searchParams.get("auth") !== "SECRET_TOKEN") {
			return new Response(null, { status: 401 });
		} else {
			// This will invoke `api-worker`
			return fetch(request);
		}
	},
};

Vytvoření Custom Domain zároveň vygeneruje Advanced Certificate ve vaší cílové zóně pro váš cílový hostname.

Tyto certifikáty se generují s výchozím nastavením. Chcete-li toto nastavení přepsat, smažte vygenerovaný certifikát a v Cloudflare dashboardu vytvořte vlastní. Více informací najdete v Správa pokročilých certifikátů s pokyny.

Protože Custom Domains vyžadují přesnou shodu názvu hostitele, Worker připojený k example.com nebude přijímat požadavky odeslané na www.example.com, a naopak. Aby fungovaly obě varianty vaší domény, nastavte pravidlo přesměrování:

• Přesměrování z www na kořenovou doménu
• Přesměrování z kořenové domény na www

Také potřebujete proxovaný DNS záznam pro hostitele, na kterého přesměrováváte od, aby Cloudflare mohl použít pravidlo přesměrování.

• Pro www na root: Přidejte proxovaný DNS A záznam pro www směřující na 192.0.2.0, nebo proxované AAAA záznam směřující na 100::
• Pro root na www: Přidejte proxovaný DNS A záznam pro vaši kořenovou doménu směřující na 192.0.2.0, nebo proxované AAAA záznam směřující na 100::

Pokud Worker aktuálně voláte pomocí trasa hodnotou /*, a máte záznam CNAME směřující na 100:: nebo podobné, doporučenou náhradou je Custom Domain.

Chcete-li migrovat trasu example.com/*:

Chcete-li migrovat trasu example.com/* ve vašem Konfigurační soubor Wrangler: