以下步骤演示如何通过命令行工具 <code>wrangler</code> 将 KV 命名空间绑定到你的 Worker。
- 配置 <code>wrangler.toml</code>
在项目根目录下的 <code>wrangler.toml</code> 文件中,添加 <code>kv_namespaces</code> 配置项:
name = "my-worker"
main = "src/index.js"
compatibility_date = "2024-01-01"
[[kv_namespaces]]
binding = "MY_KV_NAMESPACE" # Worker 中访问的变量名(通过 env.MY_KV_NAMESPACE 使用)
id = "your-kv-namespace-id" # 在 Cloudflare Dashboard 的 KV 页面获取
- binding:代码中引用的名称,例如 env.MY_KV_NAMESPACE。
- id:KV 命名空间的唯一 ID,可在控制台复制。
- 登录 Cloudflare 账号
执行以下命令,浏览器将打开登录页面:
wrangler login
- 部署 Worker
运行部署命令,wrangler 会自动读取配置并绑定 KV:
wrangler deploy
- 验证 KV 是否生效(可选)
部署后,可通过 curl 测试 Worker 接口,例如:
curl https://your-worker.dev/your-path
具体地址取决于你的 Worker 路由和代码逻辑。
提示:如需绑定多个 KV,可继续添加 [[kv_namespaces]] 块,每个块分别指定 binding 和 id。