跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

VPC 网络

最后更新 查看 MarkdownAgent 设置

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 不同,后者要求你为每个目标主机和端口组合创建单独的绑定。

绑定到 Cloudflare Tunnel

通过 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

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 地址上的不同后端:

src/index.jsjs
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(),
		});
	},
};
src/index.tsts
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

在运行时使用 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

使用 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 的比较

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)
服务注册 不需要 每个目标都需要注册
适用场景 动态发现或访问虚拟网络中的路由 固定的目录服务

后续步骤

这篇文档对您有帮助吗?