Skip to content

获取 Cloudflare API Key 与 API Token

介绍如何在 Cloudflare 控制台获取 API Key 和 API Token,用于宝塔面板(BT Panel)SSL 证书自动化申请(DNS 验证)与 Cloudflare 插件接入配置。

更新于 查看 Markdown

获取 Cloudflare API Key 和 API Token

本教程介绍如何获取 Cloudflare 的 Global API Key 和 API Token,这些凭证在以下场景中需要使用:

  • SSL 证书自动化申请:使用 DNS 验证方式申请 Let’s Encrypt 等证书时,需要通过 API 自动添加 DNS 记录
  • Cloudflare 插件配置:宝塔面板的 Cloudflare 插件需要 API 凭证来管理 DNS 记录和其他功能

API Key 与 API Token 的区别

类型 权限范围 安全性 适用场景
Global API Key 账户下所有域名的完全访问权限 较低(权限过大) 旧版集成、兼容性需求
API Token 可自定义权限和域名范围 较高(最小权限原则) 推荐使用,更安全

获取 Global API Key

1. 打开 API Tokens 页面

访问 Cloudflare API Tokens 页面并登录您的账户。

2. 查看 Global API Key

在页面底部找到 Global API Key 部分,点击 View(查看)按钮。 查看 Global API Key 按钮

系统可能会要求您完成进行验证。

3. 复制 API Key

验证通过后,Global API Key 会显示出来,点击复制保存。 显示的 Global API Key

获取 API Token(推荐)

1. 打开 API Tokens 页面

访问 Cloudflare 帐户 API 令牌 页面并登录您的账户。

2. 创建 Token

点击 Create Token(创建令牌)按钮。 创建 API Token 按钮

3. 选择模板或自定义

Cloudflare 提供了多个预设模板,我们选择:

选择 Edit zone DNS(编辑区域 DNS) 模板,或自定义配置: 选择编辑区域 DNS 模板

4. 设置 Token 名称和权限

为 Token 设置一个描述性的名称,如 BaoTa-Panel-DNS,并配置权限: 设置 Token 名称和权限

  • Permissions(权限):选择 Zone(区域) 下的 DNS,操作权限选择 Edit(编辑)
  • Zone Resources(区域资源):选择 Include(包含) → Specific zone(特定区域),然后选择您要管理的域名
  • 其他选项保持默认,或根据需要调整

::: info 说明 如您在插件中使用,建议选择 Zone(区域) 下的 Zone(区域),操作权限选择 Edit(编辑),以确保插件功能完整。 设置 Zone 编辑权限 :::

5. 创建并保存 Token

点击 Continue to summary(继续以显示摘要) Token 创建摘要

确认信息无误后点击 Create Token(创建令牌)。 创建 API Token 按钮

在宝塔面板中使用

SSL 证书申请(DNS 验证)

  1. 进入 网站 → SSL → Let’s Encrypt
  2. 验证方式选择 DNS 验证
  3. DNS 接口选择 Cloudflare
  4. 填写:
    • Cloudflare Email:您的 Cloudflare 登录邮箱
    • API Key 或 API Token:填写对应的凭证

Cloudflare 插件配置

  1. 进入 软件商店 → 安装 Cloudflare 插件
  2. 打开插件设置
  3. 填写 API 凭证:
    • 如使用 Global API Key:填写邮箱和 API Key
    • 如使用 API Token:直接填写 Token
Navigation

Type to search…

↑↓ navigate↵ selectEsc close