Skip to content
Cloudflare Docs
非官方翻译 - 此文档为非官方中文翻译版本,仅供参考。如有疑问请以 英文官方文档 为准。

本地开发

您可以通过在项目目录中运行 npx wrangler dev,在无需额外配置的情况下在本地运行容器和 Worker。

要在本地开发启用容器的 Workers,您需要首先确保安装了 Docker 兼容的 CLI 工具和引擎。例如,您可以在 Mac、Windows 或 Linux 上使用 Docker Desktop

当您运行 wrangler dev 时,您的容器镜像将被构建或下载。如果您的 wrangler 配置image 属性设置为本地路径,镜像将使用本地 Dockerfile 构建。 如果 image 属性设置为 URL,镜像将从关联的注册表拉取。

当您的 Worker 代码调用创建新容器时,容器实例将在本地启动。这可能发生在对 Container 实例调用 .get() 时,或者在 如果 manualStart 设置为 true 时调用 start()。Wrangler 将 启动新实例并自动将请求路由到正确的本地容器。

wrangler dev 停止时,所有关联的容器实例都会停止,但 本地镜像不会被移除,以便它们可以在后续调用 wrangler devwrangler deploy 时重用。

迭代容器代码

当您使用 wrangler dev 时,每次保存更改时,Wrangler 会自动重新加载您的 Worker 代码, 但容器内运行的代码不会。

要使用新的代码更改重建容器,您可以按键盘上的 [r] 键,这会 触发重建。然后容器实例将使用新构建的镜像重新启动。

您可能更愿意设置自己的代码监视器和重新加载机制,或将本地目录 挂载到本地容器镜像中以同步代码更改。这是可以做到的,但在 Wrangler 中没有内置机制来执行此操作,最佳实践将取决于您在容器代码中使用的语言和框架。