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

Migrace z Vercelu na Workers

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

Měli byste již mít existující projekt nasazený na Vercel, který chcete hostovat na Cloudflare Workers. Funkce specifické pro Vercel 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 Vercel Dashboard.

Ve svém Vercel Dashboardu najděte projekt, který chcete migrovat na Workers. Přejděte na Nastavení kartě svého projektu a najděte Nastavení buildu a vývoje panelu. Najdete zde Příkaz pro build a Output Directory pole. Pokud používáte framework, tyto hodnoty nemusí být vyplněné, ale zobrazí se výchozí hodnoty použité daným frameworkem. 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 dist.

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: statická aplikace nebo jednostránková aplikace.

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 Vercel. Nezapomeňte nastavit správnou cestu, například ./dist pokud je build adresář dist nebo ./build pokud je váš adresář sestavení build.

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 souboru wrangler 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 Vercel. 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 Vercel.

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