易图床-兼容主流对象存储OSS插件 | WordPress中文连接oss插件

1. 易图床是什么？

易图床是一款面向 WordPress 的对象存储插件。图片、音频或视频进入 WordPress 媒体库后，插件可以把文件同步到对象存储，并让媒体库和文章优先使用对象存储或 CDN 链接。

2. 使用前需要准备什么？

• 一个已经创建好的对象存储桶。
• 对象存储的 HTTPS Endpoint。
• 桶所在的 Region（地域）。
• Bucket（存储桶名称）。
• Access Key 和 Secret Key。
• 可选：已经解析好的图片域名或 CDN 域名。

基本权限通常包括：上传对象、读取/检查对象、删除对象；如果要使用“同步桶内图片到媒体库”，还需要列举桶内对象的权限。

3. 安装和进入设置页面

1. 进入 WordPress 后台，打开“插件 → 安装插件 → 上传插件”。
2. 选择易图床 ZIP 安装包，安装后点击“启用插件”。
3. 后台左侧会出现独立主菜单“易图床”，点击即可进入设置，不需要到“设置”菜单里寻找。
4. 建议先只配置对象存储并上传一张测试图片，确认无误后再启用本地删除或批量迁移。

4. 连接雨云、阿里云或腾讯云对象存储

以雨云对象存储为例

1. 进入雨云对象存储控制台，打开目标存储桶，找到 S3 兼容连接信息。
2. 易图床“对象存储”页选择“雨云”，填写 Endpoint、Region、Bucket、Access Key、Secret Key。
3. Endpoint 只填写 HTTPS 服务地址，不要填写桶目录、图片路径或 CDN 地址。
4. 点击“测试当前填写的连接”。测试无需提前保存；成功后测试文件会自动删除。
5. 看到连接成功后，再点击本页底部“保存本页设置”。

阿里云 OSS

选择“阿里云 OSS”，填写桶所在地域对应的 HTTPS Endpoint 和准确 Region。一般使用虚拟主机风格，通常不需要开启“使用路径风格地址”。

腾讯云 COS

选择“腾讯云 COS”，Endpoint 通常类似 https://cos.ap-guangzhou.myqcloud.com，Bucket 一般包含 APPID。Region 必须和桶所在地域一致。

MinIO 或其他 S3

选择“MinIO”或“通用 S3”，按服务商文档填写。如果服务商明确要求 Path Style，再开启“使用路径风格地址”。内网 Endpoint 默认会被安全策略拦截，只有确认部署环境可信时才开启“允许内网端点”。

5. 自定义域名和 CDN 怎么填写？

“对象存储公开域名”用于填写桶本身的公开访问地址；“自定义域名 / CDN 域名”用于填写您绑定到对象存储或 CDN 的图片域名。两者都只填写域名根地址，不要填写具体文件路径。

6. 上传路径、重命名和文件类型

云端目录格式

推荐路径：wp-content/uploads/{year}/{month} 或更简洁的 {year}/{month}。

重命名规则

“允许覆盖同名文件”关闭时，插件先严格按照您的规则生成名称。只有云端已经存在完全相同的对象名，才会在扩展名前添加一次 8 位随机防冲突后缀。例如 photo-a1b2c3d4.webp。这个后缀不是内容哈希。

图片、音频和视频

“上传图片”建议开启；音频和视频按需开启。视频体积和流量通常较大，请同时设置合理的单文件大小、每日上传流量和用户每小时上传次数。

7. WebP、尺寸控制和水印

图像处理发生在文件上传对象存储之前。建议先用测试图片验证主题、图片编辑插件和服务器图像库的兼容性。

自动转换为 WebP

开启后，JPEG、PNG 等新上传图片会转换成 WebP。服务器需要 GD 或 Imagick 支持 WebP：GD 较轻量，Imagick 对复杂图片、透明度和色彩的处理通常更完整。

最大宽度和高度

填写 0 表示不限制。只设置最大宽度时，插件会按比例缩小超宽图片，不会把小图片强行放大。

文字或图片水印

水印类型可选关闭、文字水印或图片水印。可以调整位置、大小和透明度。图片水印需要先从媒体库选择一张可读取的水印图。

8. 编辑器上传和媒体库云端素材

本地选择图片或粘贴剪贴板图片

在文章编辑器中选择本地图片上传，或者直接粘贴电脑剪贴板中的图片，文件会先进入 WordPress 正常上传流程，再由易图床同步。同步成功后，编辑器和媒体库返回云端地址。

粘贴外站图片链接

“编辑器粘贴外站图片自动转存图床”默认关闭。开启后，保存文章时插件会安全下载正文中的外站图片、加入媒体库、上传图床，并替换为云端地址；每次保存最多处理 5 张。关闭时保留原始外链，适合不想把其他网站图片自动本地化的用户。

媒体库如何区分云端和本地？

• 云端素材带有云朵标识。
• 附件同步成功后，媒体库只显示云端 URL，即使服务器暂时仍保留本地副本，也不会重复显示一份本地图片。
• 本地附件详情区域提供“上传到易图床”按钮，上传成功后文件 URL 会立即切换成云端地址。
• “只上传原始图片”开启后，不上传 WordPress 自动生成的缩略图；关闭时会同步缩略图并维护响应式图片链接。

9. 迁移工具的三种用法

一键迁移本地媒体

插件分批扫描媒体库，把尚未同步且符合文件类型设置的本地附件上传到对象存储。迁移成功后，会根据附件原地址与新云端地址的对应关系，在文章、页面和自定义文章类型中精确替换旧链接。

同步桶内图片到媒体库

这个功能反向读取当前桶内的图片对象，并在媒体库创建云端附件记录，不会把图片重新下载到服务器。支持 JPG、JPEG、PNG、GIF、WebP、AVIF、BMP、ICO 和 TIFF；已经按对象 Key 导入过的图片会自动跳过。

单张附件上传

打开媒体库附件详情，对尚未同步的服务器图片点击“上传到易图床”。适合只处理少量历史素材。

10. 本地延时删除与安全设置

上传后删除本地文件

开启后不会立刻删除本地文件，而是按照设置的天数延时清理。到期执行清理时，插件会再次用 HEAD 请求确认云端对象存在；验证失败就保留本地文件。

建议新站先设置 7–30 天，确认主题、备份、图片编辑和 CDN 均正常后，再逐步缩短保留时间。

上传与流量限制

“每用户每小时上传次数”可以降低登录用户恶意刷存储的风险；“全站每日上传流量”用于控制当日对象存储写入量。还应同时配置 WordPress 用户权限、服务器上传上限和对象存储费用告警。

一键删除云端文件

云端批量删除属于不可恢复操作，只处理当前配置上传目录的固定根路径，并要求输入指定确认文字。执行前务必确认桶、目录和备份。

11. 运行日志和常见排错顺序

1. 先确认 Endpoint 使用 HTTPS，Bucket 和 Region 与云平台控制台一致。
2. 点击“测试当前填写的连接”，根据错误信息检查密钥和权限。
3. 上传一张小尺寸 JPG 或 PNG，查看媒体库是否出现云朵标识、URL 是否为自定义域名。
4. WebP 失败时检查服务器 GD/Imagick 是否支持 WebP，并查看 PHP 内存限制。
5. 图片上传成功但无法显示时，检查桶的公开读取策略、CDN 回源配置、域名 HTTPS 证书和防盗链。
6. 批量迁移出现错误时查看“运行日志”，先解决第一条错误再继续。

13. 更新日志

以下记录按版本从新到旧排列。升级插件前建议备份网站数据库和重要媒体文件。