赞片CMSCDN插件

学完这篇，你能独立为赞片CMS安装并配置CDN插件，让视频、图片和静态资源走CDN加速，降低源站压力。下面按步骤操作。

第一步：确认环境并下载插件

这一步要确认你的赞片CMS版本满足要求，并拿到插件安装包。赞片CMS建议使用 v2.0.1 及以上版本，PHP 7.2~7.4，MySQL 5.7。登录宝塔面板或SSH，进入网站根目录，查看 /application/ 下是否有 plugin 文件夹。如果没有，先手动创建。

从赞片CMS官方论坛或GitHub仓库下载“赞片CMSCDN插件”压缩包，文件名通常为 zanpian_cdn.zip，版本号 v1.2.0。下载后解压，得到 cdn 文件夹，里面包含 Cdn.php、config.php、install.sql 等文件。

注意：不要从非官方渠道下载插件，避免后门。下载前核对文件哈希值，官方一般会提供 MD5。

第二步：上传插件并完成安装

这一步把插件文件放到正确位置，并在后台执行安装。用宝塔面板文件管理器进入网站根目录，依次打开 /application/plugin/，把解压后的 cdn 文件夹整体上传到这里。最终路径应为 /application/plugin/cdn/。

然后登录赞片CMS后台，默认入口是 /admin.php。依次点击左侧菜单「系统」→「应用管理」→「插件列表」。在插件列表中找到「CDN加速插件」，点击右侧的「安装」按钮。系统会提示“安装成功”，此时插件状态变为“已启用”。

注意：如果插件列表没有显示，检查文件夹权限是否为755，所有者是否为www。权限不对会导致后台读不到插件。

第三步：填写CDN基础配置

这一步配置CDN服务商信息，让插件能调用CDN API。在后台左侧菜单点击「系统」→「应用管理」→「插件列表」，找到「CDN加速插件」，点击「设置」。进入配置页后，按字段填写：

• CDN服务商：下拉选择「阿里云CDN」或「腾讯云CDN」
• 加速域名：填写你在CDN控制台添加的域名，例如 cdn.example.com
• AccessKey ID：填写阿里云或腾讯云的AccessKey ID
• AccessKey Secret：填写对应的Secret
• 默认回源地址：填写你的源站域名，例如 www.example.com

填写完成后点击页面底部的「保存配置」按钮。

注意：AccessKey Secret 不要泄露，建议使用子账号并只授予CDN刷新权限。保存后如果提示“API连接失败”，检查服务器时间是否与标准时间同步，误差超过15分钟会导致签名失败。

第四步：设置资源替换规则

这一步告诉插件哪些资源需要走CDN。仍在插件设置页，向下滚动到「资源替换」区域：

• 视频文件：勾选「启用」，扩展名填 mp4,m3u8,ts
• 图片文件：勾选「启用」，扩展名填 jpg,png,gif,webp
• 静态资源：勾选「启用」，扩展名填 css,js,woff2
• 替换模式：选择「自动替换」，插件会在输出时把源站域名替换为CDN域名

如果你只想替换部分目录，可以在「排除路径」中填写 /admin/、/api/，避免后台接口走CDN。

点击「保存配置」。然后点击「清空缓存」按钮，清除赞片CMS的模板缓存和数据缓存。

第五步：验证CDN是否生效

这一步检查前台资源是否真的走了CDN。打开网站前台，按 F12 打开开发者工具，切换到「Network」面板，刷新页面。查看视频、图片、CSS文件的请求URL，如果域名变成了你填写的CDN域名（如 cdn.example.com），说明替换成功。

还可以在CDN服务商控制台查看“实时监控”，如果流量和请求数有增长，说明CDN正在回源和分发。

注意：首次访问时CDN需要回源拉取文件，速度可能和源站一样。等几分钟后再次访问，命中缓存才会变快。如果视频无法播放，检查CDN域名的CNAME是否解析正确，以及源站是否允许CDN回源。

小结

• 安装前确认赞片CMS版本和PHP环境，插件放入 /application/plugin/cdn/
• 后台「系统」→「应用管理」→「插件列表」中安装并启用
• 配置CDN服务商的AccessKey和加速域名，保存后测试API连通性
• 按需勾选视频、图片、静态资源替换，排除后台路径
• 清空CMS缓存，用浏览器开发者工具验证资源域名是否变为CDN域名