QF.EDU

Docs
Cloudflare 配置

Cloudflare 配置

如何配置 cloudflare api。

在开始之前，您必须拥有 Cloudflare 账户并在 Cloudflare 上托管。

概述

管理员可在 /admin/domains中管理域配置，包括添加、删除和修改域。

网域配置表

短 URL 服务 "和 "电子邮件服务 "无需额外配置，激活后即可启用短 URL 和电子邮件功能（电子邮件需要设置工作人员转发）。

要启用 "DNS 记录服务"，必须在 "Cloudflare 配置（可选）"表单中填写以下字段：

  • Zone ID
  • API Key
  • Email

这些字段用于配置 Cloudflare API。如果您的域名通过 Cloudflare 托管，您可以在 Cloudflare 面板中找到这些详细信息。

Zone ID

Cloudflare 托管域名的唯一标识符，位于

https://dash.cloudflare.com/[account_id]/[zone_name]

API 密钥

访问 https://dash.cloudflare.com/profile/api-tokens，在 API 标记部分找到 Global API 密钥。

电子邮件

用于注册 Cloudflare 账户的电子邮件

您可以管理不同 Cloudflare 账户下托管的域名， ，前提是 API 密钥和电子邮件来自同一账户。

本节自 v0.6.0 版起已弃用

在开始之前，您必须拥有 Cloudflare 账户并托管在 Cloudflare 上。 在本节中，您可以更新这些变量：

.env
CLOUDFLARE_ZONE=[{"zone_id":"abc465","zone_name":"example.com"},{"zone_id":"abc465","zone_name":"example2.com"}]
CLOUDFLARE_API_KEY=1234567890abcdef1234567890abcdef
CLOUDFLARE_EMAIL=user@example.com
NEXT_PUBLIC_CLOUDFLARE_ZONE_NAME=example.com,example2.com

变量说明

cloudflare_zone

  • 描述： 一个 JSON 对象数组，每个对象包含 Cloudflare 区域的 zone_id 和 zone_name。zone_id 是域的唯一标识符，zone_name 是域名（如 example.com）。
  • 在哪里可以找到？在 Cloudflare 控制面板中，进入域名的 "概述 "部分，找到 Zone ID。
  • Example: [{"zone_id":"abc465","zone_name":"example.com"},{"zone_id":"def789","zone_name":"example2.com"}]
  • 注意：确保 zone_name 值与 NEXT_PUBLIC_CLOUDFLARE_ZONE_NAME 中列出的域一致。

说明： 导航至 Cloudflare 控制面板，选择您的账户，并在您域名的 "概述 "选项卡下找到 Zone ID。

CLOUDFLARE_API_KEY

  • 描述： 用于验证 Cloudflare API 请求的 API 密钥。
  • 在哪里可以找到： 在 Cloudflare 控制面板中，转到配置文件 > API 标记并找到您的全局 API 密钥。
  • 例如：1234567890abcdef1234567890abcdef
  • 安全提示：对此密钥保密，切勿在客户端代码中公开。

说明： 访问 https://dash.cloudflare.com/profile/api-tokens，在 API 标记部分找到 Global API Key。

CLOUDFLARE_EMAIL

  • 描述： 与 Cloudflare 帐户关联的电子邮件地址，与 API 密钥一起用于 API 身份验证。
  • 示例： user@example.com

NEXT_PUBLIC_CLOUDFLARE_ZONE_NAME

  • 描述： 以逗号分隔的域名列表（例如，"example.com,example2.com"），用于前台显示。这些域名必须与 CLOUDFLARE_ZONE 中的 zone_name 值相对应。
  • 例如：example.com,example2.com
  • 注意：由于该变量以 NEXT_PUBLIC_ 为前缀，因此会暴露给前端。确保它只包含域名，不包含敏感信息。

重要说明

  • 对应： CLOUDFLARE_ZONE "中的 zone_name 必须与 NEXT_PUBLIC_CLOUDFLARE_ZONE_NAME 中列出的域名一致。例如，如果 CLOUDFLARE_ZONE 包括 {"zone_id": "abc465", "zone_name": "example.com"} ，则 NEXT_PUBLIC_CLOUDFLARE_ZONE_NAME 应包括 example.com。
  • 安全性： 切勿在前端代码中暴露 CLOUDFLARE_API_KEY 或 CLOUDFLARE_ZONE，因为它们包含敏感信息。只有 NEXT_PUBLIC_CLOUDFLARE_ZONE_NAME 在前端使用才是安全的。
  • 验证： 确保 CLOUDFLARE_ZONE 中的 zone_id 和 zone_name 正确无误，因为不正确的值将导致 API 请求失败。 *** 使用www.DeepL.com/Translator翻译（免费版） ***

故障排除

  • API 密钥问题： 如果 API 请求失败，请验证您的 CLOUDFLARE_API_KEY 和 CLOUDFLARE_EMAIL 是否正确并具有必要的权限。
  • 区域不匹配： 如果前台显示的域名不正确，请确保 NEXT_PUBLIC_CLOUDFLARE_ZONE_NAME 与 CLOUDFLARE_ZONE 中的 zone_name 值匹配。
  • 查找区域 ID：如果无法找到您的区域 ID，请检查 Cloudflare 面板中域的 "概述 "选项卡。
自动同步认证