Workerd 说明文档

# Workerd 运行时 基于 V8 的 JS/Wasm 运行时，为 Cloudflare Workers 提供支持。可用作应用服务器、开发工具或 HTTP 代理。 ## ⚠️ 重要安全声明 **workerd 不是一个加固的沙箱。** 请勿运行不可信的代码。它旨在用于本地部署或自托管您的代码，而非多租户 SaaS。Cloudflare 生产环境添加了开源 workerd 中不存在的安全层。 ## 决策树：何时使用什么 **95% 的用户：** 使用 Wrangler - 本地开发：`wrangler dev`（内部使用 workerd） - 部署：`wrangler deploy`（部署到 Cloudflare） - 类型：`wrangler types`（生成 TypeScript 类型） **仅在以下情况直接使用原生 workerd：** - 在生产环境中自托管 Workers 运行时 - 将运行时嵌入到 C++ 应用程序中 - 自定义工具/测试基础设施 - 调试 workerd 特有的行为 **切勿将 workerd 用于：** - 运行不可信/用户提交的代码 - 多租户隔离（未加固） - 在没有额外安全层的情况下用于生产环境 ## 核心特性 - **基于标准**：Fetch API, Web Crypto, Streams, WebSocket - **纳米服务**：具有本地调用性能的服务绑定 - **能力安全**：显式绑定防止 SSRF - **向后兼容**：版本 = 支持的最大兼容日期 ## 架构 配置 (workerd.capnp) ├── 服务 (workers/endpoints) ├── 套接字 (HTTP/HTTPS 监听器) └── 扩展 (全局能力) ## 快速开始 bash workerd serve config.capnp workerd compile config.capnp myConfig -o binary workerd test config.capnp ## 平台支持与 Beta 状态 | 平台 | 状态 | 注意事项 | |----------|--------|-------| | Linux (x64) | 稳定 | 主要平台 | | macOS (x64/ARM) | 稳定 | 全面支持 | | Windows | Beta | 建议使用 WSL2 以获得最佳效果 | | Linux (ARM64) | 实验性 | 有限测试 | workerd 处于**活跃开发阶段**。可能会有破坏性变更。在生产环境中请锁定版本。 ## 核心概念 - **服务 (Service)**：命名端点（worker/网络/磁盘/外部） - **绑定 (Binding)**：基于能力的资源访问（KV/DO/R2/服务） - **兼容日期 (Compatibility date)**：功能门控（务必设置！） - **模块 (Modules)**：ES 模块（推荐）或 Service Worker 语法 ## 阅读顺序（渐进式披露） **从这里开始：** 1. 本 README（概述、决策树） 2. [patterns.md](./patterns.md) - 常见工作流、框架示例 **需要详细信息时：** 3. [configuration.md](./configuration.md) - 配置格式、服务、绑定 4. [api.md](./api.md) - 运行时 API、TypeScript 类型