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

Переход с Netlify на Workers

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

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

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

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

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

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

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

Для статический сайт, вам нужно будет добавить следующее в файл 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. На этапе настройки убедитесь, что команда сборки совпадает с командой, которую вы нашли в Netlify. Кроме того, командой развертывания должна быть команда по умолчанию npx wrangler deploy.

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

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

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

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