CCLEE OSS 使用指南：WordPress 媒体库上传同步到阿里云 OSS
CCLEE OSS 是 WordPress 阿里云 OSS 插件：后台媒体库上传的文件——图片、PDF、视频等所有附件——自动同步到你自己的阿里云 OSS Bucket，前台媒体 URL 自动重写为 OSS 或 CDN 域名（图片额外覆盖 srcset 与各尺寸缩略图）。文件访问不再经过网站服务器，由 OSS/CDN 直接响应，页面加载更快。
插件为商用授权制：授权 Token 与站点域名绑定，粘贴到设置页即可激活（离线验签，无需常连授权服务器）；插件更新由 CCLEE 更新服务器分发，仅有效授权站点可接收。
CCLEE OSS 能为你做什么
媒体加载更快。 图片是网页里占比最大的流量，附件下载同样吃带宽。启用后媒体文件直接从 OSS/CDN 域名响应，配合 CDN 加速域名可让访客就近加载，页面打开更快。
网站服务器更轻。 图片与附件的下载流量不再消耗网站服务器的带宽，服务器资源留给网站程序与动态请求，访问高峰更从容。
全自动接入，现有内容零改动。 后台上传即同步（图片、PDF、视频等全部媒体类型）；前台 URL 自动重写，主题、编辑器、已发布的文章都不需要改任何东西；图片的原图与全部缩略图尺寸一并覆盖。
故障兜底，数据安全。 OSS 任一环节异常自动回退本地，网站照常运行；媒体数据存在你自己的 Bucket 里，插件不会删除已上云的数据，授权到期也只是新上传回退本地。
适合谁用
- 媒体较多的网站：博客、作品集、WooCommerce 电商（产品图 + 变体图多）、提供 PDF 目录或资料下载的站点
- 图片加载慢、或服务器带宽吃紧的站长
- 已有阿里云账号、希望媒体数据存放在自己 Bucket 的用户（存储与流量按阿里云官方定价直接结算，数据完全在自己手里）
功能一览
| 功能 | 说明 |
|---|---|
| 上传即上云 | 后台上传的媒体文件（图片、PDF、视频等）自动推送到 OSS，无需手动迁移 |
| 全尺寸覆盖 | 原图与全部缩略图同步上传，regenerate-thumbnails 重建的尺寸同样覆盖 |
| URL 自动重写 | 原图、srcset、尺寸图 URL 指向 CDN 域名（未配置时用 Bucket 公网域名），附件下载链接同样重写 |
| 删除同步 | 可选开启：删除媒体库附件时同步删除 OSS 上的对象 |
| 静默回退 | OSS 任一环节异常自动回退本地存储，不打断 WordPress 原生流程 |
| 授权更新 | 更新包由 CCLEE 更新服务器分发并经 sha256 校验，仅有效授权站点可下载 |
快速入门
前提条件
- WordPress 6.4+，PHP 8.0+
- 阿里云账号，且已创建 Bucket（读写权限选公共读）
- CCLEE 为你的站点域名签发的授权 Token
第一步：安装并激活插件
- WordPress 后台 → 插件 → 安装插件 → 上传插件
- 选择
cclee-oss.zip→ 点击现在安装 - 安装完成后点击启用
第二步：粘贴授权 Token
- 进入 设置 → CCLEE OSS
- 在 License Token 粘贴 CCLEE 交付给你的授权 Token
- 点击保存
Token 与站点域名绑定
授权 Token 签发时绑定了你的站点域名（自动忽略 www 与端口后比对）。保存时插件会当场验签并核对域名，域名不符会被拒绝保存。站点更换域名后，需要联系 CCLEE 重新签发。
第三步：创建 RAM 子账号（最小权限）
插件只需要「向你的 Bucket 写入和删除对象」两个权限。按最小权限原则创建专用 RAM 子账号（创建权限策略 → 创建用户 → 授权，全程约 10 分钟），完整操作步骤见 阿里云 RAM 子账号配置指南。
完成后你会拿到一对 AccessKey ID / Secret，下一步填入插件时要用。
第四步：填写 OSS 配置
回到 设置 → CCLEE OSS，填入：
| 设置项 | 填写内容 |
|---|---|
| AccessKey ID / AccessKey Secret | 第三步保存的 RAM 密钥 |
| Bucket | 你的 Bucket 名 |
| Endpoint | Bucket 所在地域的公网 endpoint（见 Bucket 概览页），如 oss-cn-hangzhou.aliyuncs.com；与 Bucket 同地域的阿里云 ECS 优先填内网 endpoint |
| CDN 域名 | 可选。已给 Bucket 绑定 CDN 加速域名则填写，媒体 URL 将使用该域名；留空使用 Bucket 公网域名 |
填完点击保存。
第五步：上传测试图验证
- 后台 → 媒体 → 添加新文件，上传一张测试图片
- 在媒体库中点击该图片查看文件 URL（或打开前台引用该图的页面）
- 图片 URL 已指向 OSS/CDN 域名即为配置成功
授权与更新
到期与续期
- Token 内置有效期，到期前 14 天后台顶部会出现续期提示条
- 续期只需在设置页粘贴新 Token 并保存，无需其他操作
到期或吊销后会发生什么
插件做软降级，不做任何破坏性操作：
- 新上传的媒体改存本地，网站照常运行
- 已上传到 OSS 的文件与图片 URL 不受影响，前台展示如常
- 不会删除你 Bucket 里的任何数据
断网宽限期
授权状态随插件更新检查回传（约每 12 小时一次）。服务器临时无法联网不会立即失效——以最后一次成功校验时刻为基准，保留 14 天宽限期；期间恢复联网即自动恢复正常。
插件更新
- WordPress 后台的更新检查自动进行，有新版本时在「插件」页正常更新
- 更新包下载时经 sha256 完整性校验，不符即中止安装
- 仅有效授权站点能收到新版本
行为开关
| 开关 | 默认 | 说明 |
|---|---|---|
| Keep Local Copy | 开 | 上云后保留本地副本。当前版本始终保留本地文件（作为兜底），开关为后续版本预留 |
| Sync Delete to OSS | 关 | 删除媒体库附件时，同步删除 OSS 上的对象（原图 + 全部缩略图） |
本地文件是兜底真相
OSS 上传、删除、URL 重写任一环节失败时，插件静默回退 WordPress 原生行为（文件留在本地），你的网站不会因 OSS 故障而中断。
常见问题
用 CCLEE OSS 需要花多少钱？
费用分两部分：插件授权向 CCLEE 购买；媒体文件的存储与流量费用由你的阿里云 Bucket 按官方定价直接结算——数据在你自己的 Bucket 里，阿里云直接计费，CCLEE 不加价。
非图片文件（PDF、视频等附件）也会同步吗？
会。所有通过媒体库上传的文件都会同步到 OSS，附件的下载链接同样自动重写为 OSS/CDN 域名；缩略图子尺寸与 srcset 覆盖是图片文件特有的额外处理。
缩略图（子尺寸）也会上传到 OSS 吗？
会。原图与全部生成的子尺寸都会推送，包括 regenerate-thumbnails 这类插件重建出的尺寸；各尺寸的 srcset URL 也会一并重写指向 OSS。
授权到期后，已上云的图片会丢失吗？
**不会。**授权到期或被吊销后，插件进入软降级：只是新上传的媒体改存本地，已上传到 OSS 的文件与 URL 保持原样，前台图片照常显示，Bucket 中的数据不会被删除。
上传到 OSS 失败会影响发文章吗？
不会。上传、删除、URL 重写任一环节失败，插件都会静默回退 WordPress 原生行为（文件保留在本地媒体库），后台操作与前台访问均不受影响。
换域名或站点搬家后，授权还有效吗？
Token 与站点域名绑定。域名变化后原 Token 将无法通过校验，需要联系 CCLEE 按新域名重新签发，拿到新 Token 粘贴保存即可恢复。
可以删除本地副本、只保留 OSS 吗？
当前版本始终保留本地副本（这是稳定性兜底）。「Keep Local Copy」开关已预留，本地副本删除逻辑将在后续版本提供。
Endpoint 应该填公网还是内网？
与 Bucket 同地域的阿里云 ECS 优先填内网 endpoint（更快、不走公网）；其他情况（外部服务器、不同地域）填公网 endpoint。两类地址都能在 Bucket 概览页查到。
插件更新怎么获取？
WordPress 后台的更新检查自动进行（约每 12 小时一次），有新版本时在「插件」页正常点击更新即可，无需手动下载。更新仅对有效授权站点开放。
获取授权与技术支持
CCLEE OSS 按站点域名签发授权，支持购买、续期与换域名重签。联系我们获取授权：
联系 CCLEE