如何解决 Cloudflare Pages 部署中的 API Token 权限问题

问题描述

在部署项目到 Cloudflare Pages 时,可能会遇到以下错误:

[ERROR] A request to the Cloudflare API (/memberships) failed.
Authentication error [code: 10000]

这表明 API Token 没有足够的权限访问 Cloudflare API。

解决步骤

1. 生成 API Token

  1. 登录 Cloudflare 仪表板
  2. 点击右上角头像,选择 My Profile
  3. 在左侧菜单中,选择 API Tokens
  4. 点击 Create Token,选择模板 Edit Cloudflare Workers 或根据需要自定义权限。
  5. 生成 Token 并复制保存。

2. 配置环境变量

在部署环境中,设置 API Token 为环境变量:

export CLOUDFLARE_API_TOKEN=<YOUR_API_TOKEN>

验证环境变量是否生效:

echo $CLOUDFLARE_API_TOKEN

3. 验证登录状态

运行以下命令验证是否登录成功:

wrangler whoami

如果成功,会显示你的 Cloudflare 账户信息。

4. 检查 Token 权限

确保 Token 具有以下权限:

  • Accountaccount:read
  • Workersworkers:writeworkers_kv:writeworkers_routes:writeworkers_scripts:writeworkers_tail:read
  • Pagespages:write
  • Useruser:read

5. 重新部署项目

确保权限正确后,重新运行部署命令:

pnpm run deploy

常见问题

1. Token 无效

如果 Token 无效,重新生成并设置环境变量。

2. 权限不足

检查 Token 权限,确保具有足够的权限。

3. 环境变量未生效

确保在部署环境中正确设置了环境变量。

总结

通过生成和配置正确的 API Token,可以解决 Cloudflare Pages 部署中的权限问题。确保 Token 具有足够的权限,并在部署环境中正确设置环境变量。


欢迎指出任何有错误或不够清晰的表达,可以在下面评论区评论。

×

喜欢就点赞,疼爱就打赏

//