此示例使用 VPC Network 绑定和 Cloudflare Mesh(原名 WARP Connector),通过账户的默认虚拟网络进行连接。无需预先注册单独的主机,也无需指定 Cloudflare Tunnel UUID。
cf1:network 选择器会使用账户的默认虚拟网络。Worker 可以访问通过该网络路由的目标,包括 Mesh 节点、客户端设备、通过 Cloudflare Tunnel 或 Cloudflare Mesh 公告的子网或主机名路由,以及通过 Cloudflare WAN入口(GRE、IPsec 或 CNI)连接的目标。要选择其他已配置的虚拟网络,请参阅 VPC Networks 配置。
- 连接到私有网络的 Cloudflare Mesh 节点
- 在您的 Mesh 节点后方运行的私有服务(例如内部 API、数据库或 Web 应用程序)
在您的 Wrangler 配置中使用 network_id: "cf1:network" 将您的 Worker 绑定到 Cloudflare Mesh:
{
"$schema": "./node_modules/wrangler/config-schema.json",
"name": "mesh-gateway",
"main": "src/index.js",
"upload_source_maps": true,
// Set this to today's date
"compatibility_date": "2026-11-14",
"vpc_networks": [
{
"binding": "MESH",
"network_id": "cf1:network",
"remote": true
}
]
}"$schema" = "./node_modules/wrangler/config-schema.json"
name = "mesh-gateway"
main = "src/index.js"
upload_source_maps = true
# Set this to today's date
compatibility_date = "2026-11-14"
[[vpc_networks]]
binding = "MESH"
network_id = "cf1:network"
remote = true此绑定可以访问通过账户默认虚拟网络路由的服务,包括 Cloudflare Tunnel 后面的服务、Mesh 节点和 Cloudflare WAN 入口。
使用 VPC Network 绑定按私有 IP 地址访问服务。Cloudflare Mesh 目前仅支持基于 IP 的路由。
// You can target a Mesh node directly by its Mesh IP or any private IP
// on a subnet route behind the node
const SERVICE_IP = "10.0.1.50";
const SERVICE_PORT = 8080;
export default {
async fetch(request, env, ctx) {
try {
const response = await env.MESH.fetch(
`http://${SERVICE_IP}:${SERVICE_PORT}/api/data`,
);
return response;
} catch (error) {
// fetch() throws if the VPC Network cannot connect to the target
return new Response("Service unavailable", { status: 503 });
}
},
};与 VPC Service 不同,传递给 fetch() 的 URL 或传递给 connect() 的地址将决定实际目的地。您可以通过您的 Mesh 网络访问任何可达的 IP 和端口,而无需为每项服务创建单独的绑定。
您还可以使用 connect() 通过同一个绑定向非 HTTP 服务打开原始 TCP 套接字:
// You can target a Mesh node directly by its Mesh IP or any private IP
// on a subnet route behind the node
const REDIS_IP = "10.0.1.50";
const REDIS_PORT = 6379;
export default {
async fetch(request, env, ctx) {
try {
const socket = await env.MESH.connect(`${REDIS_IP}:${REDIS_PORT}`);
const writer = socket.writable.getWriter();
await writer.write(new TextEncoder().encode("PING\r\n"));
await writer.close();
return new Response(socket.readable);
} catch (error) {
// connect() throws if the VPC Network cannot connect to the target
return new Response("Service unavailable", { status: 503 });
}
},
};部署您的 Worker 并验证其是否可以访问您的私有服务:
npx wrangler deploy# Test accessing the internal user API
curl https://mesh-gateway.workers.dev/api/users
# Test accessing metrics by private IP
curl https://mesh-gateway.workers.dev/api/metrics- 详细了解 VPC Network 配置选项
- 参阅 Workers Binding API 参考
- 为账户设置 Cloudflare Mesh
- 探索其他示例