跳转到内容
搜索文档

身份验证

最后更新 查看 MarkdownAgent 设置

背景

在 Cloudflare 系统中,一个用户可以拥有多个账户和 zone。因此,你的用户通过单个 Cloudflare Token 在机器上全局配置。你的账户和 zone 将按项目配置,但会使用 Cloudflare Token 对所有 API 调用进行身份验证。配置文件会在计算机主目录的 .wrangler 目录中创建。


使用命令

要将 Wrangler 设置为与你的 Cloudflare 用户配合工作,请使用以下命令:

  • login:打开 Cloudflare 账户登录页面以授权 Wrangler 的命令。
  • configlogin 的替代方案,提示你输入 emailapi key。
  • whoami:运行此命令以确认配置已正确设置。成功时,此命令将打印你的账户电子邮件和项目 Wrangler 文件所需的 account_id

使用环境变量

你也可以使用环境变量配置全局用户。这是在 CI(持续集成)环境中使用 Wrangler 的首选方法。

要自定义 Wrangler 使用的身份验证令牌,你可以在运行任何 Wrangler 命令时提供 CF_ACCOUNT_IDCF_API_TOKEN 环境变量。账户 ID 可从 Cloudflare 仪表板的概览中获取,你可以创建或复用现有 API 令牌

CF_ACCOUNT_ID=accountID CF_API_TOKEN=veryLongAPIToken wrangler publish

或者,你可以改用 CF_EMAILCF_API_KEY 环境变量组合:

CF_EMAIL=cloudflareEmail CF_API_KEY=veryLongAPI wrangler publish

你还可以通过定义 CF_ZONE_ID 环境变量来指定或覆盖目标 Zone ID。

内联定义环境变量将覆盖存储在 wrangler config 或 Wrangler 文件中的默认凭据。


生成令牌

API 令牌

  1. Overview(概览) 中,选择 Get API token(获取 API 令牌)
  2. 进入 My Profile(个人资料) 页面后,选择 Create Token(创建令牌)
  3. API token templates(API 令牌模板) 部分,找到 Edit Cloudflare Workers(编辑 Cloudflare Workers) 模板并选择 Use template(使用模板)
  4. 填写其余字段,然后选择 Continue to summary(继续查看摘要),你可以在此选择 **Create Token(创建令牌)**并签发令牌以供使用。

Global API Key

  1. Overview(概览) 中,选择 Get API token(获取 API 令牌)
  2. 进入 My Profile(个人资料) 页面后,滚动到 API Keys(API 密钥)
  3. 选择 View(查看) 以复制你的 Global API Key(全局 API 密钥)。*

使用令牌

获取令牌或密钥后,你可以通过运行 wrangler config 在本地机器上设置默认凭据:

wrangler config
Enter API token:
superlongapitoken

使用 --api-key 标志来配置 email 和 global API key:

wrangler config --api-key
Enter email:
testuser@example.com
Enter global API key:
superlongapikey

这篇文档对您有帮助吗?