← Cloudflare Workers VPC / workers-vpc

Začínáme

Tento návod vás provede vytvořením první Workers VPC Service, díky které bude váš Worker moci přistupovat k prostředkům ve vaší privátní síti.

Vytvoříte aplikaci Workers, ve své privátní síti vytvoříte Tunnel pro její připojení ke Cloudflare a poté nakonfigurujete VPC Services pro služby ve své privátní síti, ke kterým chcete přistupovat z Workers.

Než začnete, ujistěte se, že jste splnili následující:

1. Zaregistrujte si účet Cloudflare ↗.
2. Nainstalujte Node.js ↗.

Dále budete potřebovat:

• Přístup k privátní síti (vaše lokální síť, AWS VPC, Azure VNet, GCP VPC nebo síť on premise)
• Connectivity Directory Bind role pro navázání na existující VPC Services z Workers.
• Nebo Connectivity Directory Admin role pro vytváření VPC Services a navazování na ně z Workers.

Vytvořte nový projekt Workeru pomocí nástroje Wrangler:

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

Při nastavení vyberte následující možnosti:

• Pro S čím byste chtěli začít?, vyberte Hello World example.
• Pro Jakou šablonu chcete použít?, vyberte Worker only.
• Pro Jaký jazyk chcete použít?, vyberte TypeScript.
• Pro Chcete používat git pro správu verzí?, vyberte Yes.
• Pro Chcete nasadit svou aplikaci?, vyberte No (před nasazením provedeme ještě několik změn).

Přejděte do adresáře svého projektu:

cd workers-vpc-app

Cloudflare Tunnel vytváří zabezpečené připojení z vaší privátní sítě ke Cloudflare. Tento tunel umožní Workers bezpečný přístup k vašim privátním prostředkům. Tunel můžete vytvořit na virtuálním počítači nebo v kontejneru ve vašem externím cloudu, případně pro účely tohoto návodu i na svém lokálním počítači.

Dashboard potvrdí, jakmile se váš tunel úspěšně připojí.

Jakmile je váš tunel připojen, musíte zajistit, aby měl přístup ke službám, k nimž chcete umožnit přístup svým Workers. Tunel by měl být nainstalován na počítači, který dokáže dosáhnout interních prostředků, jež chcete zpřístupnit službě Workers VPC. V externích cloudech to může znamenat konfiguraci Access-Control-Lists, Security Groups nebo VPC Firewall Rules, aby tunel mohl k požadovaným službám přistupovat.

Nyní, když je váš tunel spuštěný, vytvořte VPC Service, kterou mohou Workers použít k přístupu k vašim interním zdrojům:

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>

Pokud narazíte na chyby oprávnění, přečtěte si Požadované role.

Přidejte VPC Service binding do konfiguračního souboru 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>"

Nahraďte <YOUR_SERVICE_ID> s ID služby z kroku 3.

Upravte svůj Worker tak, aby používal binding VPC Service. Následující příklad:

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>;

Otestujte svůj Worker lokálně. Musíte přitom použít vzdálené VPC Services, a to buď pomocí Vzdálené vazby Workers jak bylo nastaveno ve vašem wrangler.jsonc konfigurační soubor, nebo pomocí npx wrangler dev --remote:

npx wrangler dev

Navštivte http://localhost:8787 pro otestování připojení vašeho Workeru k vaší soukromé síti.

Jakmile je testování dokončeno, nasaďte svůj Worker:

npx wrangler deploy

Váš Worker je nyní nasazen a může bezpečně přistupovat k prostředkům vaší privátní sítě přes Cloudflare Tunnel. Pokud narazíte na chyby oprávnění, přečtěte si Požadované role.

• Prozkoumejte možnosti konfigurace pro pokročilá nastavení
• Nastavení tunely s vysokou dostupností pro produkční prostředí
• Zobrazit průvodci pro jednotlivé platformy pro AWS, Azure, GCP a Kubernetes
• Podívejte se na příklady pro běžné případy užití