← Cloudflare Workers VPC / workers-vpc

Начало работы

Это руководство проведёт вас через создание первого Workers VPC Service, что позволит вашему Worker обращаться к ресурсам в вашей приватной сети.

Вы создадите приложение Workers, создадите Tunnel в своей приватной сети для подключения к Cloudflare, а затем настроите VPC Services для служб в приватной сети, к которым хотите получить доступ из Workers.

Прежде чем начать, убедитесь, что вы выполнили следующее:

1. Зарегистрируйтесь для получения Аккаунт Cloudflare ↗.
2. Установка Node.js ↗.

Кроме того, вам понадобится:

• Доступ к частной сети (ваша локальная сеть, AWS VPC, Azure VNet, GCP VPC или локальная инфраструктура)
• Connectivity Directory Bind роль для привязки к существующим VPC Services из Workers.
• Или Connectivity Directory Admin роль для создания VPC Services и привязки к ним из Workers.

Создайте новый проект Worker с помощью Wrangler:

npm create cloudflare@latest -- workers-vpc-app

Для настройки выберите следующие параметры:

• Для С чего вы хотите начать?, выберите Hello World example.
• Для Какой шаблон вы хотите использовать?, выберите Worker only.
• Для Какой язык вы хотите использовать?, выберите TypeScript.
• Для Хотите использовать git для контроля версий?, выберите Yes.
• Для Хотите развернуть приложение?, выберите No (мы внесём некоторые изменения перед развёртыванием).

Перейдите в каталог проекта:

cd workers-vpc-app

Cloudflare Tunnel создаёт защищённое соединение между вашей частной сетью и Cloudflare. Этот туннель позволяет Workers безопасно обращаться к вашим частным ресурсам. Вы можете создать туннель на виртуальной машине или в контейнере в вашем внешнем облаке или даже на локальном компьютере, если это делается только в рамках этого руководства.

Панель управления подтвердит успешное подключение туннеля.

После подключения туннеля убедитесь, что он может обращаться к сервисам, которые должны быть доступны вашим Workers. Туннель нужно установить на машине, способной достичь внутренних ресурсов, которые вы хотите открыть для Workers VPC. Во внешних облаках это может означать настройку Access-Control-Lists, Security Groups или VPC Firewall Rules, чтобы туннель мог обращаться к нужным сервисам.

Теперь, когда туннель запущен, создайте VPC Service, чтобы Workers могли обращаться к вашим внутренним ресурсам:

npx wrangler vpc service create my-private-api \
  --type http \
  --tunnel-id <YOUR_TUNNEL_ID> \
  --hostname <YOUR_HOSTNAME>

npx wrangler vpc service create my-database \
  --type tcp \
  --tcp-port 5432 \
  --app-protocol postgresql \
  --tunnel-id <YOUR_TUNNEL_ID> \
  --ipv4 <YOUR_IPV4_ADDRESS>

Если возникают ошибки доступа, см. Необходимые роли.

Добавьте привязку VPC Service в файл конфигурации Wrangler:

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "workers-vpc-app",
	"main": "src/index.ts",
	// Set this to today's date
	"compatibility_date": "2026-08-28",
	"vpc_services": [
		{
			"binding": "VPC_SERVICE",
			"service_id": "<YOUR_SERVICE_ID>"
		}
	]
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "workers-vpc-app"
main = "src/index.ts"
# Set this to today's date
compatibility_date = "2026-08-28"

[[vpc_services]]
binding = "VPC_SERVICE"
service_id = "<YOUR_SERVICE_ID>"

Замените <YOUR_SERVICE_ID> с идентификатором службы из шага 3.

Обновите ваш Worker, чтобы использовать привязку VPC Service. В следующем примере:

export default {
	async fetch(request, env, ctx): Promise<Response> {
		const url = new URL(request.url);

		// This is a simple proxy scenario.
		// In this case, you will need to replace the URL with the proper protocol (http vs. https), hostname and port of the service.
		// For example, this could be "http://localhost:1111", "http://192.0.0.1:3000", "https://my-internal-api.example.com"
		const targetUrl = new URL(
			`http://<ENTER_SERVICE_HOST>:<ENTER_SERVICE_PORT>${url.pathname}${url.search}`,
		);

		// Create new request with the target URL but preserve all other properties
		const proxyRequest = new Request(targetUrl, {
			method: request.method,
			headers: request.headers,
			body: request.body,
		});

		const response = await env.VPC_SERVICE.fetch(proxyRequest);

		return response;
	},
} satisfies ExportedHandler<Env>;

Тестируйте свой Worker локально. Вам нужно использовать удалённые VPC Services с помощью Удалённые привязки Workers как было настроено в вашем wrangler.jsonc файл конфигурации, либо с помощью npx wrangler dev --remote:

npx wrangler dev

Перейдите на http://localhost:8787 чтобы проверить подключение вашего Worker к приватной сети.

После завершения тестирования разверните Worker:

npx wrangler deploy

Теперь ваш Worker развёрнут и может безопасно обращаться к ресурсам вашей приватной сети через Cloudflare Tunnel. Если у вас возникают ошибки прав доступа, см. Необходимые роли.

• Изучите параметры конфигурации для сложных сценариев настройки
• Настройка туннели высокой доступности для рабочей среды
• Просмотр руководства для конкретных платформ для AWS, Azure, GCP и Kubernetes
• Ознакомьтесь с примеры для распространенных сценариев использования