小Q云IDC Cloudflare DNS 二级域名分发插件使用教程

小Q云IDC Cloudflare DNS 二级域名分发插件是一款专为IDCsmart系统量身定制的自动化解析管理工具，旨在通过对接 Cloudflare 提供的高性能 API，自动完成用户二级域名的创建、分发、暂停和删除等操作，从而帮助服务商实现云产品的快速上线、自动部署及统一域名管理。这款插件特别适用于需要批量管理子域名的场景，如CDN节点分发、SaaS服务开通、面板系统接入等，大大提升了工作效率，简化了复杂的运维流程，是现代IDC业务不可或缺的重要组件。

该插件支持对接多个Cloudflare账户和多个主域名，可通过系统后台自由配置主域名池，系统将自动从可用主域名中选择一个进行子域分发。用户在购买产品（如CDN节点、分销主机、独立宝塔等）时，插件会根据设定自动生成唯一的二级域名并同步到Cloudflare DNS，实现真正意义上的“零人工干预”。所有DNS记录均通过Cloudflare的API接口实时写入，支持A记录和CNAME记录等常见类型，确保解析速度快、稳定性强。

插件还支持产品状态与DNS状态联动功能，当用户暂停、关闭或删除服务时，系统会自动同步Cloudflare解析记录进行暂停或移除，确保子域名不再指向失效服务，提升系统的安全性与专业性。通过与IDCsmart平台深度集成，该插件还能与自动部署、API交付、用户管理等功能联动，实现完整的域名生命周期管理。

对于服务商而言，该插件解决了传统二级域名分配中存在的多个痛点：如人工手动设置效率低、易出错；子域过多难以维护；客户不具备专业DNS知识导致解析问题频发等。而通过自动化的方式，每一位客户都能在服务开通的第一时间获得专属子域名并即时生效，用户体验得到显著提升，服务口碑也会同步增强。

此外，插件在稳定性和安全性方面也做了充分设计。所有操作均通过Cloudflare官方API进行，无需暴露管理面板，降低安全风险。插件支持记录变更日志与定期验证DNS状态，确保所有子域始终处于有效可控状态。对于需要部署在多个区域节点的服务场景，插件也可实现分地域分发子域的策略配置，以满足不同地区的访问加速或接入需求。

总结来说，小Q云IDC Cloudflare DNS 二级域名分发插件不仅是一款功能强大的自动化工具，更是云服务商构建专业、高效、低维护运营体系的关键基础设施之一。它将繁琐的人工解析流程彻底交由系统智能完成，大幅度提升了系统自动化水平和用户满意度，是面向未来IDC业务发展趋势的重要利器。如果你正在寻找一种高效、安全、灵活的二级域名分发解决方案，该插件无疑是最值得信赖的选择。

1. 安装插件

安装小Q云IDC Cloudflare DNS 二级域名分发插件十分简单，仅需几步操作即可完成部署并投入使用。

首先，请下载本文末尾提供的插件压缩包，并将其上传至您魔方财务系统的插件目录路径：/public/plugins/servers。上传完成后，在该目录中解压压缩包。

解压后，您将看到一个名为 cloudflare 的文件夹。请确认该文件夹内包含两个文件：cloudflare.php 和 information.html。其中，cloudflare.php 是插件的核心程序文件，负责实现 Cloudflare API 接口通信与业务逻辑处理；而 information.html 是插件的信息模板文件，用于在魔方财务后台中展示插件的简介与使用说明，不会参与功能执行。

确认文件无误后，即表示插件安装已完成。接下来请登录魔方财务后台，进入【设置】>【商品设置】>【通用接口】页面，在下拉列表中选择“cloudflare”，即可将该插件与具体产品对接，实现自动分发子域名的功能。

整个安装过程无需更改系统核心代码，操作简单、安全高效。完成安装后，您便可以进入后续的参数配置步骤，实现全自动的二级域名解析服务。

2. 配置 Cloudflare 接口

在完成插件安装后，为了使其能够自动对接 Cloudflare 并实现二级域名的解析操作，您需要创建并配置一个专用的 Cloudflare API 令牌（API Token）。此令牌将授权插件访问您指定域名的 DNS 记录，确保插件具备自动添加、删除和暂停子域名的权限。

如果您尚未拥有 Cloudflare 账号，请先前往官方网站 https://www.cloudflare.com 注册一个账号。注册流程简单，仅需提供邮箱与密码，注册完成后请登录您的账户。

接下来，我们开始配置 API 令牌。请点击页面右上角的头像图标，进入“配置文件（Profile）”页面。在左侧导航栏中找到“API 令牌（API Tokens）”选项，点击进入后，点击“创建令牌（Create Token）”按钮，开始新令牌的创建流程。

请注意，这里我们需要的是“API 令牌”，不要选择 Global API Key（全局 API 密钥）。API 令牌具有更精细的权限控制和更高的安全性，是 Cloudflare 官方推荐的最佳实践。

在令牌模板页面中，找到并选择“编辑区域 DNS（Edit Zone DNS）”模板。这个模板预设了对指定域名 DNS 的读取和写入权限，非常适合我们的插件使用。点击“使用模板（Use Template）”进入下一步。

权限部分无需修改，保持默认即可。接下来，在“区域资源（Zone Resources）”处，选择“特定区域（Specific Zone）”，然后从下拉菜单中选择您计划用于子域名分发的主域名。插件将通过此域名生成并解析所有子域名，因此请确保所选域名已成功接入 Cloudflare 并处于“活动”状态。

在“客户端 IP 地址筛选（Client IP Address Filtering）”部分，您可以选择是否进行 IP 白名单限制。如果您希望仅允许特定服务器调用此令牌，可填写您服务器的公网 IP 地址。此步骤虽然为可选项，但出于安全性考虑，建议填写，以防止令牌被恶意滥用。

“有效期限（TTL）”默认即可，若您对安全性有更高要求，也可以设置令牌的有效期，例如 30 天或 90 天，以便后续定期轮换和更新令牌。

完成以上配置后，点击“继续以显示摘要（Continue to summary）”，检查您设置的信息是否正确。如果一切无误，点击“创建令牌（Create Token）”按钮，Cloudflare 系统将立即生成一个专属的 API 令牌。

请将这个令牌字符串复制并妥善保存，注意不要泄露该令牌内容，因为拥有此令牌的任何人都可以通过 Cloudflare API 控制您指定域名下的 DNS 记录，可能会导致严重的安全隐患。

下一步，您将在魔方财务系统中打开插件并填写此 API 令牌，以实现接口的完整对接。至此，Cloudflare 接口配置流程就完成了，为插件提供了所需的访问权限，后续操作将真正实现自动化的子域名创建与解析功能。

3.配置魔方财务通用接口

按照图片所示打开对应页面

在配置 Cloudflare 插件后，请务必确认插件的连接状态为“连接成功”，这是确保后续自动分发、暂停、删除子域名等操作能够正常执行的关键前提。如果连接失败，系统将无法通过 API 与 Cloudflare 通信，所有功能将报错或无法生效。

如果在保存配置后遇到提示：

API 错误：Invalid request headers（错误代码：6003）

请按以下几个方向仔细排查原因：

1. 是否使用了 Global API Key
本插件只支持 API Token，不支持全局 API 密钥（Global API Key）。请确认您在 Cloudflare 中创建的是具有“编辑区域 DNS”权限的 API Token，而非 Global Key。错误的身份认证方式将导致请求头被拒绝，从而触发错误代码 6003。

2. 是否启用了 IP 白名单限制
若在创建令牌时启用了“客户端 IP 地址筛选”功能，则 Cloudflare 仅允许来自指定 IP 的请求。如果您填写的 IP 与实际服务器公网 IP 不一致，同样会导致连接失败。建议在确认服务器公网 IP 后重新填写，或先临时关闭此限制以测试连接。

3. 是否使用了错误或失效的 API Token
API Token 如果被误删、手动吊销，或者设置了过期时间且当前已过期，插件将无法验证身份，请重新创建令牌并替换。

4. 是否存在权限配置错误
API Token 权限必须包含“编辑区域 DNS”权限，且“区域资源”需绑定您实际用于子域名解析的主域名。如果未设置、设置错误，或仅赋予了只读权限，也会导致插件操作失败。

请确保上述配置全部正确无误，并重新保存插件设置。只有当状态显示为“连接成功”时，插件才能顺利与 Cloudflare 对接，实现各项自动化解析功能。

4.配置商品

如果上面的都没问题那么恭喜你可以开始下一步配置商品了 请按照下方图片一步步的来哦

好现在基础配置已经配置好了 接下来是重中之重 请一点要对上对不上一定是开通失败的

至此，如果前面的配置步骤都已正确完成，并且插件状态显示为“连接成功”，那么恭喜您，Cloudflare 二级域名分发插件已经可以正式投入使用了！后续您在魔方财务系统中创建商品时，只需选择该插件作为接口，即可实现用户下单后自动为其分配一个独立的二级域名，并绑定至 Cloudflare，极大地提升了业务部署的自动化程度和效率。

在此，我们由衷地感谢您对 小Q云IDC 的信任与支持。每一位用户的选择和反馈，都是推动我们不断前行的重要动力。这个插件的开发初衷，是为了帮助广大云服务提供商、IDC运维人员更轻松地管理二级域名资源，减少重复劳动，同时提升系统的专业性和客户体验。我们深知，真正优秀的工具不仅要“能用”，还要“好用”，而这一切的实现，离不开您的关注和建议。

如果您在使用过程中觉得插件确实帮上了忙，也欢迎您支持一下插件作者 —— 请他喝一杯星巴克 ☕️，您的每一份肯定都是我们继续优化产品、拓展功能的强大动力。您可以在插件信息页面找到支持方式，也可以通过官方渠道联系小Q云IDC团队提出建议或合作意向。

再次感谢您的陪伴与使用，小Q云IDC 将继续秉持初心，为广大用户带来更高效、更智能、更便捷的云端工具和解决方案！