← Cloudflare Workers / workers / static-assets / migration-guides

Migrace z Netlify na Workers

V tomto tutoriálu se naučíte, jak migrovat svou aplikaci Netlify na Cloudflare Workers.

Měli byste již mít existující projekt nasazený na Netlify, který chcete hostovat na Cloudflare Workers. Funkce specifické pro Netlify nejsou v Cloudflare Workers podporovány. Projděte si Matice kompatibility Workers další informace o tom, co je podporováno.

Některé frameworky, jako Next.js, Astro s vykreslováním na vyžádání a další, mají vlastní návody pro migraci na Cloudflare Workers. Podívejte se na náš průvodci pro frameworky další informace. Pokud váš framework má Nasaďte existující projekt na Workers průvodce, postupujte podle něj pro konkrétní pokyny. V opačném případě pokračujte podle kroků níže.

Chcete-li přesunout svou aplikaci na Cloudflare Workers, budete potřebovat znát svůj build command a build directory. Cloudflare Workers tyto informace použije k sestavení a nasazení vaší aplikace. Níže si ukážeme, jak tyto hodnoty najít v Netlify Dashboard.

Ve svém Netlify Dashboardu najděte projekt, který chcete migrovat na Workers. Přejděte na Konfigurace projektu menu pro váš konkrétní projekt a poté přejděte do Build a nasazení položku nabídky. Zde najdete Nastavení sestavení kartu, která obsahuje Příkaz sestavení a Adresář pro publikování pole. Uložte si je pro nasazení do Cloudflare Workers. Na obrázku níže jsou pole Příkaz pro build je npm run build, a Output Directory je .next.

V kořenovém adresáři projektu vytvořte wrangler.jsonc nebo wrangler.toml soubor (wrangler.jsonc se doporučuje). Obsah souboru závisí na typu nasazované aplikace: aplikace poháněná Generování statických stránek (SSG), nebo Jednostránková aplikace (SPA).

V každém případě nezapomeňte aktualizovat <your-project-name> hodnota s názvem vašeho projektu a <your-build-directory> hodnota s adresářem sestavení (build directory) z Netlify.

Pro statický web, budete muset do souboru wrangler přidat následující.

{
	"name": "<your-project-name>",
	// Set this to today's date
	"compatibility_date": "2026-08-28",
	"assets": {
		"directory": "<your-build-directory>",
	},
}

name = "<your-project-name>"
# Set this to today's date
compatibility_date = "2026-08-28"

[assets]
directory = "<your-build-directory>"

Pro Jednostránková aplikace, budete muset do konfiguračního souboru Wrangleru přidat následující, což zahrnuje not_found_handling .

{
	"name": "<your-project-name>",
	// Set this to today's date
	"compatibility_date": "2026-08-28",
	"assets": {
		"directory": "<your-build-directory>",
		"not_found_handling": "single-page-application",
	},
}

name = "<your-project-name>"
# Set this to today's date
compatibility_date = "2026-08-28"

[assets]
directory = "<your-build-directory>"
not_found_handling = "single-page-application"

Některé frameworky mají vlastní návody pro migraci na Cloudflare Workers. Podívejte se na náš průvodci pro frameworky další informace. Pokud váš framework obsahuje průvodce „Deploy an existing project on Workers“, postupujte podle něj a najdete v něm podrobné pokyny.

Vaše aplikace má správnou konfiguraci pro sestavení a nasazení do Cloudflare Workers.

Připojte nový Worker průvodce vás provede tím, jak připojit svůj projekt GitHub ke Cloudflare Workers. V kroku konfigurace se ujistěte, že příkaz pro sestavení je stejný jako příkaz, který jste našli na Netlify. Příkaz pro nasazení by také měl zůstat výchozí npx wrangler deploy.

Workers Custom Domains podporuje pouze domény, které jsou ve vašem účtu nakonfigurované jako zóny. Zóna je doména (například example.com), kterou pro vás Cloudflare spravuje, včetně jejího DNS a provozu.

Postupujte podle těchto pokynů pro přidání vlastní domény do vašeho projektu Workers. Najdete zde také další informace o vytvoření zóny pro vaši doménu.

Jakmile máte vlastní doménu nastavenou a odesílá požadavky na Cloudflare Workers, můžete bezpečně smazat svou aplikaci Netlify.

Další pokyny k migraci najdete v Průvodce migrací z Cloudflare Pages na Workers. I když to není specifické pro Netlify, popisuje to i některé další kroky, které mohou být užitečné.