Workers VPC: network_id = "cf1:vnet:<UUID>" でバインディングごとに仮想ネットワークを選ぶ

VPC Network バインディングの network_id に仮想ネットワークの UUID を指定できるようになり、1 つの Worker から「同じプライベート IP を使う本番と検証の裏側」を別々に呼び分けられる（2026-10-28）。

どんなときに使う？

本番と検証の VPC がどちらも 10.0.0.0/16 のように同じアドレス帯で、既定の仮想ネットワーク 1 つでは衝突する
1 つの管理用 Worker から複数環境の内部 API を叩きたい
Cloudflare Mesh + Workers VPC: エージェントと Workers を同じプライベート網に載せるで作った私設網を環境ごとに分けたい

やり方

wrangler.jsonc:

jsonc

{
  "vpc_networks": [
    { "binding": "PRODUCTION", "network_id": "cf1:vnet:<PRODUCTION_VNET_UUID>", "remote": true },
    { "binding": "STAGING",    "network_id": "cf1:vnet:<STAGING_VNET_UUID>",    "remote": true }
  ]
}

wrangler.toml なら [[vpc_networks]] を 2 つ並べる。コードでは env.PRODUCTION と env.STAGING をそれぞれのバインディングとして使う。

アカウントの既定の仮想ネットワークを使うときは、これまでどおり network_id = "cf1:network"。

注意点

UUID は Cloudflare One 側で作った仮想ネットワークの ID。環境ごとの Tunnel やコネクタがそれぞれの仮想ネットワークにひも付いている必要がある。
同じ IP 帯でも衝突しないのは「バインディングごとに網が分かれている」から。どちらのバインディングで呼ぶかを取り違えると、同じ IP で別環境に届くので、バインディング名は環境名にしておくのが安全。

出典

@CFchangelog · 2026-10-30
Cloudflare Changelog「Select a virtual network for VPC Network bindings」 developers.cloudflare.com