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

将 Worker 连接到 Cloudflare Mesh

最后更新 查看 MarkdownAgent 设置

此示例使用 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 应用程序)

1. 配置您的 Worker

在您的 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 入口。

2. 实施 Worker

使用 VPC Network 绑定按私有 IP 地址访问服务。Cloudflare Mesh 目前仅支持基于 IP 的路由。

index.jsjs
// 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 和端口,而无需为每项服务创建单独的绑定。

TCP 连接

您还可以使用 connect() 通过同一个绑定向非 HTTP 服务打开原始 TCP 套接字:

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

3. 部署并测试

部署您的 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

后续步骤

这篇文档对您有帮助吗?