1 插件简介

CDN 管理插件（Cdnpro）是为迅睿 CMS 开发的 CDN 运维管理应用插件，将腾讯云 CDN、腾讯云 EdgeOne（边缘安全加速平台）、阿里云 ESA（边缘安全加速）与 Cloudflare 四家 CDN 平台的常用运维操作集成到网站后台，无需分别登录各厂商控制台，即可完成 CDN 配置管理、缓存刷新与访问数据概览。

本插件核心能力如下：

• CDN 配置：在后台统一填写四家厂商的 API 凭据（SecretId/SecretKey、AccessKey、API Token 等），密钥经混淆处理后写入配置文件，避免明文落盘；

• CDN 缓存刷新：支持按文件 URL、目录提交刷新任务，EdgeOne 与 Cloudflare 额外支持全站刷新，提交后自动记录任务编号与状态；

• 访问数据概览：按时间范围（今天、近 7 天、近 30 天、近 90 天）查询总流量、总请求数、带宽峰值、缓存命中率，并展示流量趋势曲线与 CDN 配置信息表。

2 功能概览

3 安装与升级

3.1 安装插件

1. 将压缩包 cdnpro-1.0.0.zip 上传到服务器；

2. 在迅睿后台【应用】→【应用管理】中上传安装本插件（zip 包直接上传安装）；

3. 安装完成后在【应用管理】中启用本插件；

4. 在【系统】→【更新缓存】中更新缓存，后台左侧菜单即出现【CDN 管理】分组。

3.2 覆盖升级

新版本压缩包直接上传覆盖安装即可。覆盖安装后务必执行【系统】→【更新缓存】，并刷新浏览器（Ctrl+F5），否则页面可能仍显示旧版模板。

3.3 开始使用

1. 打开【CDN 配置】，填写对应厂商的 API 凭据并保存，保存后更新缓存；

2. 打开【数据概览】，查看统计卡、流量趋势曲线与 CDN 配置信息表；

3. 打开【缓存刷新】，选择厂商与刷新类型并填写地址，提交刷新任务。

4 厂商凭据配置

4.1 腾讯云 CDN

登录腾讯云控制台，访问【访问管理】→【API 密钥管理】（https://console.cloud.tencent.com/cam/capi）创建或获取 SecretId 与 SecretKey。需开通 CDN 服务，且密钥具备缓存刷新（PurgeTask）与数据查询（DescribeCdnData）权限，建议使用子账号并做最小权限授权。

4.2 腾讯云 EdgeOne

EdgeOne 使用与腾讯云 CDN 相同的 CAM API 密钥（SecretId／SecretKey）。如需按站点维度查询数据概览，可额外填写站点 ID（ZoneId，在 EdgeOne 控制台站点详情页获取，多个站点用英文逗号分隔）；留空时查询主账号全部站点（需具备全站资源权限）。

4.3 阿里云 ESA

登录阿里云控制台，访问【RAM 访问控制】→【AccessKey 管理】（https://ram.console.aliyun.com/manage/ak）创建 AccessKeyId 与 AccessKeySecret。需开通 ESA 服务并授权缓存刷新与数据查询权限。可选填站点 ID（SiteId，通过 ListSites 接口获取），用于数据概览按站点过滤；不填时查询账户维度数据。

4.4 Cloudflare

登录 Cloudflare 控制台，访问【My Profile】→【API Tokens】（https://dash.cloudflare.com/profile/api-tokens）创建 API Token，需包含 Zone 级 Cache Purge（缓存清除）与 Analytics（数据分析）只读权限。Zone ID 在目标域名详情页右下角获取。

4.5 凭据保存说明

插件将四家厂商的配置统一保存于站点配置文件（WRITEPATH/config/cdnpro.php），密钥字段经 Base64 混淆后存储，避免直接明文写入配置文件；重新保存时如某密钥留空，则保持原值不变。请妥善保管 API 密钥，勿泄露给无关人员。

5 功能使用说明

5.1 数据概览

进入【CDN 管理】→【数据概览】。顶部工具栏显示当前生效厂商（只读，自动取第一个已配置凭据的厂商）与时间范围下拉（今天、近 7 天、近 30 天、近 90 天）。页面组成如下：

• 统计卡：总流量、总请求数、带宽峰值、缓存命中率四项指标；

• 流量趋势：所选时间范围内的流量折线图（单位 MB），数据通过异步接口加载；

• CDN 配置信息表：加速域名、状态、CNAME、源站类型、源站配置、拓展服务、HTTPS 配置状态七列。

厂商切换：数据概览默认展示已配置凭据的厂商；当多家厂商均已配置时，可在概览地址后追加 provider 参数切换，例如 ?provider=tencent、?provider=edgeone、?provider=aliyun、?provider=cloudflare。

5.2 缓存刷新

进入【CDN 管理】→【缓存刷新】。顶部以 Tab 形式选择厂商（与 CDN 配置页一致），再选择刷新类型：

• 文件 URL：每行填写一个完整 URL（如 https：//www.example.com/js/app.js）；

• 目录：每行填写一个以斜杠结尾的目录地址（如 https：//www.example.com/images/）；

• 全站：仅 EdgeOne 与 Cloudflare 显示并支持，刷新该站点下全部缓存。

提交成功后页面显示提示浮层（含任务编号），并自动刷新记录列表；提交失败时显示红色提示条。刷新记录表保留最近 50 条任务，含提交时间、厂商、类型、地址、任务编号与状态。部分厂商刷新任务需数分钟在边缘节点生效，可在对应厂商控制台查看任务进度。

5.3 使用说明

数据概览、缓存刷新、CDN 配置页面的右上角菜单均提供【使用说明】入口，点击进入内置说明页，含四厂商配置指南、常见问题表与其他说明。

6 数据口径与限制

说明：缓存命中率仅腾讯云 CDN 官方接口提供，EdgeOne、阿里云 ESA、Cloudflare 的官方查询接口无命中率指标，故显示“-”；阿里云 ESA 与 Cloudflare 的源站配置、HTTPS 配置状态字段，官方查询接口不直接返回，故配置信息表中相应列显示“-”。

7 常见问题与注意事项

7.1 权限与安全提示

建议为插件使用最小权限的专用密钥：腾讯云使用子账号密钥并仅授权 CDN／EdgeOne 相关操作，阿里云使用 RAM 子用户密钥并仅授权 ESA 相关操作，Cloudflare 使用限定 Zone 与权限的 API Token。切勿在服务器配置文件中存放高权限根密钥。