# 开始使用文派智储：五分钟把媒体库搬进对象存储

## 文派智储是什么

文派智储（WPSSS）把 WordPress 媒体库的图片、视频、文档上传到对象存储桶（如阿里云 OSS、腾讯云 COS），页面仍在源站渲染。访客的下载流量从源站卸载到云厂商，源站只负责 PHP 与数据库——这是大流量站点最常见的加速结构之一。

它与「整站搬到云」不同：你的 WordPress 还是原来的 WordPress，只是 `wp-content/uploads` 里的文件住进了桶里，前台地址自动指向桶域名。

## 工作原理速览

- **上传即进桶**：媒体库新上传的附件自动写入桶；本地是否保留副本由「本地备份」开关决定。
- **地址自动改写**：文章、缩略图、srcset、REST 接口里的媒体地址在渲染时换成桶域名，数据库里的原始数据不动。
- **页面留源站**：HTML、PHP、后台不走桶，缓存策略与现在完全一致。

## 安装与激活

1. 在插件页上传安装 wpsss.zip，或把解压后的目录放到 `wp-content/plugins/`。
2. 激活后左侧菜单出现「文派智储」，进入先看概览页；未配置时点「开始设置向导」走四步。
3. 向导第 1 步选择站点场景（国内 / 跨境 / 混合），影响推荐的厂商排序。
4. 第 2 步填桶名、区域、AccessKey——建议先用**测试桶**走完流程，确认无误再切生产桶。
5. 第 3 步先看「已为你配置」清单与运行体检；第 4 步完成页点「测试连通」：插件会向桶写入一个临时对象并删除，验证密钥与权限真的可用。

## 第一次补传存量媒体

配置完成后，到「工具 → 日常」点「开始补传」。队列一次上传一个附件，页面显示实时进度；中途可以暂停，关掉页面也行——后台每分钟最多补 2 个，慢慢清完。一个几千附件的站通常几个小时收尾，不需要守着。

新上传的附件不需要补传，上传那一刻已经进桶了。

## 回退

随时可以停用插件：标记与桶内对象都在，重新激活即恢复。想完全回到本地，用「拉回本地」把文件取回来，再解除进桶标记。详见《拉回本地与卸载》。

---