赞片CMSOSS插件

学完这篇，你能在自己的赞片 CMS 站点上装好 OSS 插件，把封面图、视频文件从服务器本地硬盘搬到阿里云 OSS，并保证前台播放和图片显示都正常。下面按顺序做就行，全程大约 20 分钟。

第一步：在阿里云侧把 Bucket 和密钥准备好

这一步做完，你会拿到 4 个值：AccessKeyId、AccessKeySecret、Bucket 名称、EndPoint，后面填插件全靠它们。

登录阿里云控制台，顶栏搜索「对象存储 OSS」进入 Bucket 列表，点「创建 Bucket」。地域选离你服务器最近的，比如服务器在杭州就选 oss-cn-hangzhou；读写权限选「公共读」，否则前台图片会 403。创建完成后点进 Bucket，在「概览」页右下角能看到外网访问的 EndPoint，形如 oss-cn-hangzhou.aliyuncs.com。

密钥不要用主账号的。右上角头像 → 访问控制 RAM → 用户 → 创建用户，勾选「OpenAPI 调用访问」，拿到一对 AccessKey。再给它授权，权限策略只勾该 Bucket 的读写即可。

注意：主账号 AK 泄露等于整个云账号裸奔，一定要用 RAM 子账号，并且只授权单个 Bucket。

第二步：上传并安装 OSS 插件

这一步做完，插件会出现在后台插件列表里并处于「已安装」状态。

进入赞片 CMS 后台，路径是「系统 → 插件管理 → 上传插件」，选择你下载的 OSS 插件 zip 包（常见命名如 oss_upload.zip），点上传。上传成功后列表里会出现该插件，点右侧「安装」，几秒钟后状态变成「已启用」。

如果按钮上传失败，就手动来：把 zip 解压后整个文件夹传到服务器 /application/plugin/ 目录下，回到后台刷新插件管理页面即可看到。

注意：插件目录必须有写权限，否则安装时报「目录不可写」。用宝塔面板的话，在「文件」里右键插件目录 → 权限，所有者设为 www，权限 755。

第三步：填写插件配置

这一步做完，插件就真的连上你的 OSS 了。

在「系统 → 插件管理」找到 OSS 插件，点「配置」，逐项填：

• AccessKeyId / AccessKeySecret：第一步拿到的两个值
• Bucket：Bucket 名称，如 myvideo
• EndPoint：oss-cn-hangzhou.aliyuncs.com，注意不要带 http://，也不要带 Bucket 前缀
• 绑定域名：你的 CDN 加速域名或 OSS 外网域名，带协议，如 https://img.example.com
• 根目录：一般填 uploads/，末尾带斜杠
• 本地保留：选「否」，省服务器空间

保存后点配置页上的「测试上传」按钮，返回一串以绑定域名开头的地址就算通了。

注意：EndPoint 写成 https://myvideo.oss-cn-hangzhou.aliyuncs.com 是最常见的报错原因，插件会再拼一次域名，结果就是 404。

第四步：把上传通道切到 OSS

这一步做完，之后新上传的图片和视频才会走 OSS，不切的话插件装了也白装。

路径是「系统 → 基本设置 → 附件设置」，把「上传方式」从「本地」改成「阿里云 OSS」，保存。然后去「系统 → 缓存管理」，点「清除全部缓存」。

第五步：验证上传和播放

这一步做完，你能确认前后台都正常。

进「内容管理 → 视频管理 → 添加视频」，上传一张封面图，提交后回到列表，看图片地址是不是绑定域名开头。再随便打开一个视频详情页，确认 m3u8 能正常播放。

如果图片能传但前台显示裂图，去 OSS 控制台 → 该 Bucket → 「数据安全 → 跨域设置 → 创建规则」，来源填 *，方法勾上 GET、POST、PUT、HEAD，允许 Headers 填 *。

如果视频在其他网站能播、在你站点不播，检查 Bucket 的「防盗链」设置，把本站域名加进 Referer 白名单。

注意：站点是 HTTPS 但绑定域名填的是 http://，浏览器会拦截混合内容，图片和视频都会静默失败，控制台里能看到一片红色报错。

小结

• 阿里云侧要准备好 4 个值：AccessKeyId、AccessKeySecret、Bucket、EndPoint，权限用 RAM 子账号最小授权
• 插件安装路径是「系统 → 插件管理 → 上传插件」，失败就手动放到 /application/plugin/
• EndPoint 不带协议和 Bucket 前缀，绑定域名要带协议
• 装完插件必须去「基本设置 → 附件设置」把上传方式切成 OSS，并清缓存
• 上传通了但前台不显示，优先查跨域设置和 HTTPS 混合内容