VPC 网络允许 Workers 访问私有网络中的任何服务,无需预先注册单独的主机或端口。你可以绑定到特定的 Cloudflare Tunnel,以访问该隧道后面的任何服务;也可以绑定到 Cloudflare Mesh,以访问通过 Cloudflare Tunnel 或 Mesh 公告的任何 Mesh 节点、客户端设备、子网路由或主机名路由,或者访问通过 Cloudflare WAN入口(GRE、IPsec 或 CNI)可到达的目标。
在运行时,传递给 fetch() 的 URL 或传递给 connect() 的地址决定目标位置,即通过绑定的 Cloudflare Tunnel 或 Cloudflare Mesh 可到达的任何主机名或 IP 地址。HTTP 流量使用 fetch(),原始 TCP 连接(Redis、MQTT、自定义协议和其他非 HTTP 服务)使用 connect()。这与 VPC Services 不同,后者要求你为每个目标主机和端口组合创建单独的绑定。
通过 UUID 直接引用特定的 Cloudflare Tunnel:
{
"vpc_networks": [
{
"binding": "MY_VPC",
"tunnel_id": "550e8400-e29b-41d4-a716-446655440000",
"remote": true
}
]
}[[vpc_networks]]
binding = "MY_VPC"
tunnel_id = "550e8400-e29b-41d4-a716-446655440000"
remote = true本地开发时,必须将 remote 标志设为 true 才能启用远程绑定。
Cloudflare Mesh(原名 WARP Connector)通过 Cloudflare 全球网络连接你的服务、设备和 Workers。当你使用 network_id: "cf1:network" 绑定 Worker 时,绑定会使用账户的默认虚拟网络。Worker 可以访问:
- 账户中的任何 Mesh 节点或客户端设备
- 通过 Cloudflare Tunnel 或 Cloudflare Mesh 公告的子网路由和主机名路由
- 通过 Cloudflare WAN入口(GRE、IPsec 和 CNI)可到达的目标
- 通过 Cloudflare Gateway访问公共 Internet 目标,同时强制执行现有 Zero Trust 流量策略,并将流量记录在 DNS、HTTP 和 Network 日志中
完成以上配置无需指定特定的 Cloudflare Tunnel UUID。
以下情况适合使用 cf1:network:
- 你的 Workers 需要访问跨多个 Cloudflare Tunnel、Mesh 节点或 Cloudflare WAN 入口的私有服务
- 你希望 Worker 能访问整个私有网络,而无需管理单独的 Cloudflare Tunnel 绑定
- 你的私有网络拓扑可能会变化(新增连接、节点或路由),而你不想每次都更新 Worker 配置
- 你希望 Worker 发往公共目标的流量通过 Cloudflare Gateway,以便执行策略并获得可见性
如果 Workers VPC 的 HTTP 流量匹配 Forward policy(Beta),Gateway 会丢弃该流量。请在 Forward 策略中排除 Workers VPC 流量。
使用 network_id: "cf1:network" 绑定到 Cloudflare Mesh:
{
"vpc_networks": [
{
"binding": "MY_VPC",
"network_id": "cf1:network",
"remote": true
}
]
}[[vpc_networks]]
binding = "MY_VPC"
network_id = "cf1:network"
remote = true将 network_id 设置为 cf1:vnet:<VNET_UUID>,通过特定的已配置虚拟网络访问服务。你可以使用不同绑定选择不同的虚拟网络,即使这些网络使用了重叠的 IP 范围也可以。
例如,以下绑定分别选择生产和预发布虚拟网络:
{
"vpc_networks": [
{
"binding": "PRODUCTION",
"network_id": "cf1:vnet:<PRODUCTION_VNET_UUID>",
"remote": true
},
{
"binding": "STAGING",
"network_id": "cf1:vnet:<STAGING_VNET_UUID>",
"remote": true
}
]
}[[vpc_networks]]
binding = "PRODUCTION"
network_id = "cf1:vnet:<PRODUCTION_VNET_UUID>"
remote = true
[[vpc_networks]]
binding = "STAGING"
network_id = "cf1:vnet:<STAGING_VNET_UUID>"
remote = true每个绑定都可以访问同一私有 IP 地址上的不同后端:
export default {
async fetch(_request, env) {
const production = await env.PRODUCTION.fetch("http://10.0.1.50/status");
const staging = await env.STAGING.fetch("http://10.0.1.50/status");
return Response.json({
production: await production.text(),
staging: await staging.text(),
});
},
};export default {
async fetch(_request: Request, env: Env): Promise<Response> {
const production = await env.PRODUCTION.fetch(
"http://10.0.1.50/status",
);
const staging = await env.STAGING.fetch("http://10.0.1.50/status");
return Response.json({
production: await production.text(),
staging: await staging.text(),
});
},
} satisfies ExportedHandler<Env>;在运行时使用 fetch() 访问网络中的任何 HTTP 服务:
export default {
async fetch(request: Request, env: Env) {
// Access a service by private IP
const response = await env.MY_VPC.fetch("http://10.0.1.50/data");
// Access another service on a different port
const dbResponse = await env.MY_VPC.fetch("http://10.0.5.42:5432");
return response;
},
};当 VPC Network 无法与目标服务建立连接时,fetch() 会抛出异常。
使用 connect()打开到任何私有目标的原始 TCP 连接。这适用于 Redis、Memcached、MQTT 或自定义二进制协议等非 HTTP 协议:
export default {
async fetch(request: Request, env: Env) {
// Open a TCP connection to a private Redis instance
const socket = await env.MY_VPC.connect("10.0.1.50:6379");
// Write a Redis PING command
const writer = socket.writable.getWriter();
await writer.write(new TextEncoder().encode("PING\r\n"));
await writer.close();
return new Response(socket.readable);
},
};当 VPC Network 无法建立 TCP 连接时,connect() 会抛出异常。
通过 VPC Network 绑定发送的流量会显示在 Gateway 网络日志中,Traffic Source 为 Workers VPC。
Zero Trust Network Session Logs 也会记录每个会话由哪个 Worker 发起。Workers VPC 会话的 OnrampType 为 WORKERS_VPC,SourceName 为 Worker 名称,SourceID 为 Worker 的稳定标识符。使用这些字段可审计哪个 Worker 访问了私有服务,或调试连接失败问题。
VPC Networks 和 VPC Services 都可以将 Workers 连接到私有基础设施,但二者的取舍不同。
- 使用 VPC Services 的情况:目标集合已知,并且你希望每个绑定限定到特定的主机和端口。
- 使用 VPC Networks 的情况:你需要广泛访问整个 Cloudflare Tunnel 或虚拟网络中的路由,并希望通过
fetch()调用中的 URL 在运行时控制路由。
下表总结了二者的差异:
| 功能 | VPC Networks | VPC Services |
|---|---|---|
| 范围 | Cloudflare Tunnel 或虚拟网络中的路由 | 特定主机 + 端口 |
| 配置 | tunnel_id、cf1:network 或 cf1:vnet:<UUID> |
service_id |
| 协议 | HTTP(fetch())和 TCP(connect()) |
HTTP(fetch())或 TCP(通过 Hyperdrive) |
| 服务注册 | 不需要 | 每个目标都需要注册 |
| 适用场景 | 动态发现或访问虚拟网络中的路由 | 固定的目录服务 |