您可以通过在项目目录中运行 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 dev
或 wrangler deploy
时重用。
当您使用 wrangler dev
时,每次保存更改时,Wrangler 会自动重新加载您的 Worker 代码,
但容器内运行的代码不会。
要使用新的代码更改重建容器,您可以按键盘上的 [r]
键,这会
触发重建。然后容器实例将使用新构建的镜像重新启动。
您可能更愿意设置自己的代码监视器和重新加载机制,或将本地目录 挂载到本地容器镜像中以同步代码更改。这是可以做到的,但在 Wrangler 中没有内置机制来执行此操作,最佳实践将取决于您在容器代码中使用的语言和框架。
- @2025 Cloudflare Ubitools
- Cf Repo