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

共享本地 dev 服务器

最后更新 查看 MarkdownAgent 设置

当你需要共享预览、测试 webhook 或从其他设备访问应用时,可以通过 Cloudflare Tunnel 暴露本地 dev 服务器。

本页介绍 Wrangler 和 Cloudflare Vite 插件 中的隧道支持。

启动隧道

你可以使用 Wrangler 或 Cloudflare Vite 插件为当前会话启动隧道。通过快速隧道,你会获得随机的 *.trycloudflare.com 主机名;通过命名隧道,则会获得稳定的主机名。

Wrangler

运行 wrangler dev,然后按 [t] 启动或关闭隧道。Wrangler 会打印当前会话的公共隧道 URL。

要使用 named tunnel,请运行:

npx wrangler dev --tunnel-name=my-tunnel

如果希望 Wrangler 启动时自动打开隧道,请使用 --tunnel。

npx wrangler dev --tunnel

Cloudflare Vite 插件

运行 vite dev,然后按 t + Enter 启动或关闭隧道。如果希望配置 named tunnel 或在 Vite 启动时自动打开隧道,请在插件配置中添加 tunnel。

要使用具有稳定主机名的 named tunnel:

vite.config.jsjs
import { defineConfig } from "vite";
import { cloudflare } from "@cloudflare/vite-plugin";

export default defineConfig({
	plugins: [
		cloudflare({
			tunnel: { name: "my-tunnel" },
		}),
	],
});
vite.config.tsts
import { defineConfig } from "vite";
import { cloudflare } from "@cloudflare/vite-plugin";

export default defineConfig({
    plugins: [
        cloudflare({
            tunnel: { name: "my-tunnel" },
        }),
    ],
});

如果希望 Vite 启动时自动打开隧道,请将 tunnel.autoStart 设置为 true。

使用 vite preview 时,Vite 的 preview 主机验证仍然适用:

  • 对于 Quick tunnel,将 .trycloudflare.com 添加到 preview.allowedHosts。
  • 对于 named tunnel,将解析后的主机名或匹配的后缀(如 .my-domain.com)添加到 preview.allowedHosts。

例如:

vite.config.jsjs
import { defineConfig } from "vite";
import { cloudflare } from "@cloudflare/vite-plugin";

export default defineConfig({
	preview: {
		allowedHosts: [
			// For Quick tunnels:
			".trycloudflare.com",
			// For named tunnels:
			".my-domain.com",
		],
	},
	plugins: [
		cloudflare({
			tunnel: { name: "my-tunnel" },
		}),
	],
});
vite.config.tsts
import { defineConfig } from "vite";
import { cloudflare } from "@cloudflare/vite-plugin";

export default defineConfig({
    preview: {
        allowedHosts: [
            // For Quick tunnels:
            ".trycloudflare.com",
            // For named tunnels:
            ".my-domain.com"
        ],
    },
    plugins: [
        cloudflare({
            tunnel: { name: "my-tunnel" },
        }),
    ],
});

安全注意事项

无论是否使用隧道,本地开发安全注意事项都适用。隧道会让开发服务器可从远程访问,从而增加暴露风险,但不会为本地 workerd 进程添加安全隔离。

除非隧道受到访问控制保护,否则任何持有其 URL 的人都可以访问开发服务器。启动隧道前,请检查应用公开了哪些内容。

  • 特别注意未设访问控制的预览或管理端点。
  • 不要公开接受并执行用户提供代码的端点。
  • 审查连接到真实资源的任何远程绑定(remote bindings)。
  • 审查将请求代理到私有或内部服务的任何代码。
  • 如果在使用 vite dev 时搭配 Cloudflare Vite 插件,HMR 和模块服务可能会通过隧道公开源文件、文件路径或项目结构。如果只需共享构建后的预览,请优先使用 vite preview 进行公开分享。这可以减少源代码暴露,但不会增加运行时隔离。
  • 本地开发相关路由(如 /cdn-cgi/*)仍受限制,不会通过隧道暴露。
  • 如果需要稳定的主机名或更严格的访问控制,请使用受 Cloudflare Access 保护的命名隧道。Access 可以限制谁能访问服务器,但不会强化本地运行时的安全性。

相关文档

这篇文档对您有帮助吗?