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
首发版本
下载地址:
分享






