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

Перенос с Vercel на Workers

В этом руководстве вы узнаете, как перенести приложение с Vercel на Cloudflare Workers.

Предполагается, что у вас уже есть проект, развёрнутый на Vercel, который вы хотите разместить на Cloudflare Workers. Специфичные для Vercel функции Cloudflare Workers не поддерживает. Ознакомьтесь с таблица совместимости Workers с дополнительной информацией о том, что поддерживается.

Для некоторых фреймворков, например Next.js, Astro с рендерингом по требованию и других, есть отдельные руководства по переносу на Cloudflare Workers. См. наш руководства по фреймворкам для дополнительной информации. Если в вашем фреймворке есть Развертывание существующего проекта на Workers руководство, следуйте его инструкциям. В противном случае продолжайте выполнять шаги ниже.

Чтобы перенести приложение на Cloudflare Workers, нужно знать команду сборки и директорию сборки. Cloudflare Workers будет использовать эту информацию для сборки и развёртывания приложения. Ниже показано, как найти эти значения в Vercel Dashboard.

В Vercel Dashboard найдите проект, который нужно перенести на Workers. Перейдите в Настройки вкладку для вашего конкретного проекта и найдите Настройки сборки и разработки панели. Там вы найдёте Команда сборки и Выходной каталог поля там. Если вы используете фреймворк, эти значения могут быть не заполнены, но будут отображать значения по умолчанию, используемые фреймворком. Сохраните их для развертывания на Cloudflare Workers. На изображении ниже Команда сборки это npm run build, и Выходной каталог это dist.

В корне проекта создайте wrangler.jsonc или wrangler.toml файл (wrangler.jsonc рекомендуется). Содержимое файла зависит от типа развертываемого приложения: статическое приложение или одностраничное приложение.

В каждом случае обязательно обновляйте <your-project-name> значение на имя вашего проекта и <your-build-directory> значение с каталогом сборки из Vercel. Обязательно укажите правильный путь, например ./dist если каталог сборки задан как dist или ./build если каталогом сборки является build.

Для статический сайт, вам нужно будет добавить следующее в файл wrangler.

{
	"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>"

Для одностраничное приложение, вам нужно будет добавить следующее в файл wrangler, включая 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"

Для некоторых фреймворков есть отдельные руководства по переносу на Cloudflare Workers. См. наш руководства по фреймворкам для дополнительной информации. Если в вашем фреймворке есть руководство «Разверните существующий проект на Workers», следуйте ему для получения подробных инструкций.

У вашего приложения есть конфигурация, необходимая для сборки и развёртывания на Cloudflare Workers.

Подключение нового Worker руководство расскажет, как подключить ваш проект GitHub к Cloudflare Workers. На этапе настройки убедитесь, что команда сборки совпадает с командой, которую вы нашли в Vercel. Кроме того, командой развертывания должна быть команда по умолчанию npx wrangler deploy.

Workers Custom Domains поддерживает только домены, настроенные как зоны в вашем аккаунте. Зоной называется домен (например, example.com), которым Cloudflare управляет за вас, включая его DNS и трафик.

Следуйте инструкциям для добавление собственного домена в ваш проект Workers. Там же вы найдёте дополнительную информацию о создании зоны для вашего домена.

После настройки пользовательского домена и отправки запросов в Cloudflare Workers можно безопасно удалить приложение Vercel.

Дополнительные инструкции по миграции см. в Руководство по миграции с Cloudflare Pages на Workers. Хотя это не относится непосредственно к Vercel, здесь описаны дополнительные шаги, которые могут быть полезны.