获取 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(查看)按钮。

系统可能会要求您完成进行验证。
3. 复制 API Key
验证通过后,Global API Key 会显示出来,点击复制保存。

获取 API Token(推荐)
1. 打开 API Tokens 页面
访问 Cloudflare 帐户 API 令牌 页面并登录您的账户。
2. 创建 Token
点击 Create Token(创建令牌)按钮。

3. 选择模板或自定义
Cloudflare 提供了多个预设模板,我们选择:
选择 Edit zone DNS(编辑区域 DNS) 模板,或自定义配置:

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

- Permissions(权限):选择
Zone(区域)下的DNS,操作权限选择Edit(编辑) - Zone Resources(区域资源):选择
Include(包含) →Specific zone(特定区域),然后选择您要管理的域名 - 其他选项保持默认,或根据需要调整
::: info 说明
如您在插件中使用,建议选择 Zone(区域) 下的 Zone(区域),操作权限选择 Edit(编辑),以确保插件功能完整。
:::
5. 创建并保存 Token
点击 Continue to summary(继续以显示摘要)

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

在宝塔面板中使用
SSL 证书申请(DNS 验证)
- 进入 网站 → SSL → Let’s Encrypt
- 验证方式选择 DNS 验证
- DNS 接口选择 Cloudflare
- 填写:
- Cloudflare Email:您的 Cloudflare 登录邮箱
- API Key 或 API Token:填写对应的凭证
Cloudflare 插件配置
- 进入 软件商店 → 安装 Cloudflare 插件
- 打开插件设置
- 填写 API 凭证:
- 如使用 Global API Key:填写邮箱和 API Key
- 如使用 API Token:直接填写 Token