VeImageX-Sync插件

zuoyunlai 2 min read
VeImageX-Sync插件

WordPress 媒体库自动同步到火山引擎 veImageX,前台图片替换为 CDN 链接。

简介

上传图片到 WordPress 媒体库时自动同步到火山引擎 veImageX(图片加速服务), 同时将前台展示的图片 URL 替换为自定义 CDN 域名,提升网站加载速度。

功能:

上传同步:媒体库上传新图片时自动同步到 veImageX(主文件 + 缩略图)

  • 前台替换:`wp_get_attachment_url`、`srcset`、媒体编辑器预览全部替换为 CDN 地址
  • 删除同步:在媒体库删除图片时同步删除 veImageX 上的文件
  • 批量同步:一键将已有媒体库图片批量上传到 veImageX
  • 停用开关:随时切回本地图片,无需卸载插件
  • 流式上传:大文件不占内存,直接流式传输

安装

上传 `veimagex-sync` 文件夹到 `/wp-content/plugins/` 目录

在 WordPress 后台「插件」页面启用插件

进入「设置 → veImageX 配置」填写:

  • AccessKey ID / Secret Access Key:火山引擎密钥管理获取
  • Service ID:veImageX 控制台服务管理获取
  • CDN 域名:绑定的自定义加速域名

保存配置后即可使用

常见问题

如何停用 CDN 但保留配置?

在设置页面勾选「停用 veImageX 同步」即可,URL 替换和自动上传都会暂停, 配置不会丢失。取消勾选即恢复。

已有图片怎么同步?

在设置页面点击「开始批量同步」按钮即可。

图片太大导致内存溢出怎么办?

插件使用流式上传,不将文件内容加载到内存,大文件也可以正常上传。

更新日志

1.1.0

  • 新增停用开关(切回本地图片)
  • 优化上传逻辑,避免大文件内存溢出
  • 添加配置页面帮助链接

1.0.0

首发版本

下载地址:

https://github.com/zuoyunlai/veImageX-Sync

文章评分 成为第一个评分的人
zuoyunlai

风云三尺剑,花鸟一床书