Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/zuoyunlai/veimagex-sync/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
WordPress 媒体库自动同步到火山引擎 veImageX，前台图片替换为 CDN 链接。
Description
上传图片到 WordPress 媒体库时自动同步到火山引擎 veImageX（图片加速服务）， 同时将前台展示的图片 URL 替换为自定义 CDN 域名，提升网站加载速度。
功能：
- 上传同步：媒体库上传新图片时自动同步到 veImageX（主文件 + 缩略图）
- 前台替换：
wp_get_attachment_url、srcset、媒体编辑器预览全部替换为 CDN 地址 - 删除同步：在媒体库删除图片时同步删除 veImageX 上的文件
- 批量同步：一键将已有媒体库图片批量上传到 veImageX
- 停用开关：随时切回本地图片，无需卸载插件
- 流式上传：大文件不占内存，直接流式传输
Installation
- 上传
veimagex-sync文件夹到/wp-content/plugins/目录 - 在 WordPress 后台「插件」页面启用插件
- 进入「设置 → veImageX 配置」填写：
- AccessKey ID / Secret Access Key：火山引擎密钥管理获取
- Service ID：veImageX 控制台服务管理获取
- CDN 域名：绑定的自定义加速域名
- 保存配置后即可使用
Frequently Asked Questions
如何停用 CDN 但保留配置？
在设置页面勾选「停用 veImageX 同步」即可，URL 替换和自动上传都会暂停， 配置不会丢失。取消勾选即恢复。
已有图片怎么同步？
在设置页面点击「开始批量同步」按钮即可。
图片太大导致内存溢出怎么办？
插件使用流式上传，不将文件内容加载到内存，大文件也可以正常上传。
Changelog
1.1.0
- 新增停用开关（切回本地图片）
- 优化上传逻辑，避免大文件内存溢出
- 添加配置页面帮助链接
1.0.0
- 首发版本