[wrangler] Add vpc_networks binding support by RiscadoA · Pull Request #12992 · cloudflare/workers-sdk

RiscadoA · 2026-03-20T15:28:53Z

Fixes WVPC-172.

Adds vpc_networks binding support, allowing Workers to route traffic through a Cloudflare Tunnel. At runtime, env.MY_VPC.fetch("http://internal-host/") routes through the tunnel. Each binding generates a Fetcher type. Like vpc_services, these bindings are always remote in wrangler dev.

Network bindings are configured through either a tunnel_id or a network_id:

{
  "vpc_networks": [{ "binding": "MY_FOO_VPC", "tunnel_id": "your-tunnel-uuid" }]
}

{
  "vpc_networks": [{ "binding": "MY_BAR_VPC", "network_id": "some-network-id" }]
}

Tests
- Tests included/updated
Public documentation
- Cloudflare docs PR(s): Add VPC Networks docs cloudflare-docs#29313

changeset-bot · 2026-03-20T16:00:18Z

🦋 Changeset detected

Latest commit: 3bd1f9c

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

workers-devprod · 2026-03-25T18:34:35Z

Codeowners approval required for this PR:

@cloudflare/wrangler

Show detailed file reviewers

packages/miniflare/src/plugins/index.ts: [@cloudflare/wrangler]
packages/miniflare/src/plugins/vpc-networks/index.ts: [@cloudflare/wrangler]
packages/workers-utils/src/config/config.ts: [@cloudflare/wrangler]
packages/workers-utils/src/config/environment.ts: [@cloudflare/wrangler]
packages/workers-utils/src/config/validation.ts: [@cloudflare/wrangler]
packages/workers-utils/src/map-worker-metadata-bindings.ts: [@cloudflare/wrangler]
packages/workers-utils/src/types.ts: [@cloudflare/wrangler]
packages/workers-utils/src/worker.ts: [@cloudflare/wrangler]
packages/workers-utils/tests/config/validation/normalize-and-validate-config.test.ts: [@cloudflare/wrangler]
packages/wrangler/e2e/remote-binding/miniflare-remote-resources.test.ts: [@cloudflare/wrangler]
packages/wrangler/e2e/remote-binding/workers/vpc-network.js: [@cloudflare/wrangler]
packages/wrangler/src/tests/api/startDevWorker/utils.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/deploy/durable-objects.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/deploy/get-remote-config-diff.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/tests/type-generation.test.ts: [@cloudflare/wrangler]
packages/wrangler/src/api/remoteBindings/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/api/startDevWorker/utils.ts: [@cloudflare/wrangler]
packages/wrangler/src/deploy/check-remote-secrets-override.ts: [@cloudflare/wrangler]
packages/wrangler/src/deploy/config-diffs.ts: [@cloudflare/wrangler]
packages/wrangler/src/deployment-bundle/create-worker-upload-form.ts: [@cloudflare/wrangler]
packages/wrangler/src/dev/miniflare/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/type-generation/index.ts: [@cloudflare/wrangler]
packages/wrangler/src/utils/print-bindings.ts: [@cloudflare/wrangler]

pkg-pr-new · 2026-03-25T18:38:40Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@12992

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@12992

miniflare

npm i https://pkg.pr.new/miniflare@12992

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@12992

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@12992

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@12992

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@12992

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@12992

wrangler

npm i https://pkg.pr.new/wrangler@12992

commit: 3bd1f9c

thomasgauvin

LGTM

packages/workers-utils/src/config/validation.ts

.changeset/vpc-networks-binding.md

packages/miniflare/src/plugins/vpc-networks/index.ts

packages/workers-utils/src/config/environment.ts

packages/workers-utils/src/config/validation.ts

xortive · 2026-04-01T14:28:22Z

Approved from WVPC PoV

workers-devprod

Codeowners reviews satisfied

RiscadoA force-pushed the rantunes/WVPC-172-phase1 branch from b0de6cb to 3fac7aa Compare March 20, 2026 16:00

workers-devprod added this to workers-sdk Mar 20, 2026

github-project-automation bot moved this to Untriaged in workers-sdk Mar 20, 2026

RiscadoA force-pushed the rantunes/WVPC-172-phase1 branch 8 times, most recently from ba592eb to 9d6de13 Compare March 25, 2026 18:33

RiscadoA marked this pull request as ready for review March 25, 2026 18:34

RiscadoA requested a review from a team as a code owner March 25, 2026 18:34

RiscadoA requested a review from edmundhung March 25, 2026 18:34

This comment was marked as resolved.

Sign in to view

RiscadoA mentioned this pull request Mar 26, 2026

[wrangler] Add vpc networks commands for managing VPC Networks #12833

Closed

5 tasks

RiscadoA force-pushed the rantunes/WVPC-172-phase1 branch 2 times, most recently from ec90908 to 2ef1741 Compare March 26, 2026 09:19

RiscadoA mentioned this pull request Mar 26, 2026

[wrangler] Add vpc network commands #13064

Draft

5 tasks

thomasgauvin approved these changes Mar 26, 2026

View reviewed changes

edmundhung reviewed Mar 26, 2026

View reviewed changes

edmundhung added the run-remote-tests label Mar 26, 2026

RiscadoA force-pushed the rantunes/WVPC-172-phase1 branch 2 times, most recently from 315f520 to 3446b43 Compare March 27, 2026 10:34

This comment was marked as resolved.

Sign in to view

RiscadoA force-pushed the rantunes/WVPC-172-phase1 branch from 3446b43 to 5209a58 Compare March 27, 2026 10:53

This comment was marked as resolved.

Sign in to view

github-actions bot mentioned this pull request Mar 31, 2026

Run CI on behalf of #12992 @4280008 #13152

Closed

workers-devprod pushed a commit that referenced this pull request Mar 31, 2026

Trigger CI for #12992

7d27920

github-actions bot mentioned this pull request Mar 31, 2026

Run CI on behalf of #12992 @4280008 #13153

Closed

workers-devprod pushed a commit that referenced this pull request Mar 31, 2026

Trigger CI for #12992

0803ef5

RiscadoA force-pushed the rantunes/WVPC-172-phase1 branch 2 times, most recently from ddb6fcb to 73d97df Compare April 1, 2026 10:12

github-actions bot mentioned this pull request Apr 1, 2026

Run CI on behalf of #12992 @73d97df #13184

Closed

workers-devprod pushed a commit that referenced this pull request Apr 1, 2026

Trigger CI for #12992

ae910e8

edmundhung reviewed Apr 1, 2026

View reviewed changes

packages/workers-utils/src/config/validation.ts Outdated Show resolved Hide resolved

RiscadoA force-pushed the rantunes/WVPC-172-phase1 branch from 73d97df to 423217e Compare April 1, 2026 13:34

github-actions bot mentioned this pull request Apr 1, 2026

Run CI on behalf of #12992 @423217e #13190

Closed

workers-devprod pushed a commit that referenced this pull request Apr 1, 2026

Trigger CI for #12992

fbc3fe0

RiscadoA force-pushed the rantunes/WVPC-172-phase1 branch from 423217e to 7134458 Compare April 1, 2026 14:01

This comment was marked as resolved.

Sign in to view

RiscadoA force-pushed the rantunes/WVPC-172-phase1 branch from 7134458 to 6a0e2f4 Compare April 1, 2026 14:08

github-actions bot mentioned this pull request Apr 1, 2026

Run CI on behalf of #12992 @6a0e2f4 #13192

Closed

workers-devprod pushed a commit that referenced this pull request Apr 1, 2026

Trigger CI for #12992

46c0c17

edmundhung approved these changes Apr 1, 2026

View reviewed changes

Ricardo Antunes added 4 commits April 1, 2026 16:03

[workers-utils] Add vpc_networks binding type

24df7c8

[miniflare] Add vpc-networks plugin

57fb8f2

[wrangler] Add vpc_networks binding support

9764f09

[wrangler] Fix error propagation in remote proxy worker

3bd1f9c

edmundhung force-pushed the rantunes/WVPC-172-phase1 branch from 6a0e2f4 to 3bd1f9c Compare April 1, 2026 15:03

edmundhung requested a review from workers-devprod as a code owner April 1, 2026 15:03

workers-devprod approved these changes Apr 1, 2026

View reviewed changes

github-project-automation bot moved this from Untriaged to Approved in workers-sdk Apr 1, 2026

edmundhung merged commit 48d83ca into cloudflare:main Apr 1, 2026
47 checks passed

github-project-automation bot moved this from Approved to Done in workers-sdk Apr 1, 2026

workers-devprod mentioned this pull request Apr 1, 2026

Version Packages #13141

Merged

Conversation

RiscadoA commented Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

workers-devprod commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

pkg-pr-new bot commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

thomasgauvin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

xortive commented Apr 1, 2026

Uh oh!

workers-devprod left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

RiscadoA commented Mar 20, 2026 •

edited

Loading

changeset-bot bot commented Mar 20, 2026 •

edited

Loading

workers-devprod commented Mar 25, 2026 •

edited

Loading

pkg-pr-new bot commented Mar 25, 2026 •

edited

Loading