cloudflare/workerd

这是什么？

核心功能

• 01运行为 Cloudflare Workers 编写的 JavaScript 和 Wasm 代码。
• 02将应用拆分为可在同一进程内调用的 nanoservice。
• 03使用 Cap'n Proto 配置文件和 capability bindings 连接资源。
• 04支持兼容性日期，可模拟历史版本的 API 行为。
• 05可作为正向或反向的可编程 HTTP 代理运行。
• 06支持通过 --socket-fd 继承 systemd 提供的套接字。

适用场景

• 自托管原本为 Cloudflare Workers 设计的应用。
• 配合 Wrangler 在本地开发和测试 Workers 代码。
• 构建可编程的 HTTP 代理，用于修改或路由请求。

快速上手

1. 1

   使用 Bazel 构建 workerd 二进制文件

   bazel build //src/workerd/server:workerd
2. 2

   编写配置文件（例如 my-config.capnp），定义服务和套接字

3. 3

   使用 workerd 运行你的配置

   workerd serve my-config.capnp

使用前须知

• !workerd 不是经过加固的沙箱，运行不可信代码时需要放在虚拟机或其他安全沙箱中。
• !从源码构建需要较大的工具链，例如 Linux 上的 clang 22+、libc++ 22+ 和 LLD 22+，或 macOS 上的 Xcode 16.3。
• !官方仅在 Linux、macOS 和 Windows 的 x86-64 与 arm64 架构上测试。

标签

常见问题

workerd 是什么？

基于 Cloudflare Workers 同款代码的 JavaScript/Wasm 服务端运行时，可用于自托管与本地开发。 workerd 是一个服务端运行时，可以执行为 Cloudflare Workers 编写的 JavaScript 和 WebAssembly 代码。它既能作为应用服务器自托管 Workers 应用，也能作为本地开发和测试工具，或者作为可编程的正向/反向 HTTP 代理，用来拦截、修改和路由网络请求。

workerd 可以免费使用吗？用的什么许可证？

workerd 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

workerd 还在维护吗？

活跃维护中。workerd 最近一次提交是在 2026年10月21日。

workerd 适合用来做什么？

自托管原本为 Cloudflare Workers 设计的应用。 配合 Wrangler 在本地开发和测试 Workers 代码。 构建可编程的 HTTP 代理，用于修改或路由请求。

workerd 怎么安装和运行？

使用 Bazel 构建 workerd 二进制文件: bazel build //src/workerd/server:workerd 编写配置文件（例如 my-config.capnp），定义服务和套接字 使用 workerd 运行你的配置: workerd serve my-config.capnp

在哪里获取 workerd？

源代码和安装说明在 GitHub 上：https://github.com/cloudflare/workerd