要完成火山引擎 veImageX 的 CDN 图片加速配置，需要打通服务创建、镜像回源、图片模板设置这三大关键步骤：先在火山引擎中创建 veImageX 图像处理服务并绑定 CDN 域名；再设置主/备回源地址，实现图片自动回源拉取；最后按照“先缩放、后裁剪”的顺序新建 URL 参数化模板，供 WPJAM Basic 插件直接调用。

如果想让 WordPress 博客的静态资源通过火山引擎 veImageX 实现 CDN 加速，必须完整完成服务创建、镜像回源和图片模板配置这三步。三者缺一不可，否则很容易出现图片无法自动拉取、缩略图处理失效，或者 CDN 域名解析完成后依然返回 404 的情况。

创建 veImageX 图像处理服务

登录火山引擎控制台，进入「veImageX」服务列表，点击右上角「服务管理」→「新建服务」。

填写服务信息时，服务名称可自定义（如 wp-static-cdn）；地区建议选择访客最集中的区域，例如华南-广州；服务类型选择「图像处理服务」；绑定域名填写你预先准备好的 CDN 子域名（如 cdn.srrui.com）；服务属性必须选择「永久保存」。

【绑定域名必须提前在 DNS 解析中添加 CNAME 记录，指向 veImageX 提供的 CNAME 值，否则后续所有配置都不会生效】

保存后，服务会进入审核流程，通常 5–15 分钟即可完成。审核通过后，页面会显示该服务对应的 CNAME 值，请及时复制，并在域名服务商后台为对应子域名添加或更新 CNAME 解析记录。

配置镜像回源规则

服务创建完成后，进入该服务详情页，点击左侧菜单「基础配置」，然后滚动到「镜像回源」区域。

主回源地址填写你的 WordPress 博客完整 HTTP/HTTPS 地址（如 https://srrui.com）。注意必须包含协议头，并且结尾不能带斜杠。

如果你此前已经把本地图片迁移出去，原图仅保存在旧 CDN 中（如七牛），可以在「备用回源地址」中填写旧 CDN 域名（如 qiniu.srrui.com）。当 veImageX 访问主源返回 404 时，会自动切换到备用源进行回源拉取，从而避免图片链接失效或页面出现裂图。

这里不需要手动同步资源。所有未命中缓存的图片在首次被访问时，veImageX 都会自动从回源地址抓取并缓存，之后的访问请求会直接由 CDN 节点返回内容，从而提升加载速度和访问稳定性。

设置图片处理模板

返回服务详情页，点击「图片配置」→「新建模板」。

第一步，在常规编辑中，「输出格式」建议勾选「保持源格式」，这样可以避免强制转换为 WebP，减少 Safari 或部分旧版浏览器出现兼容性问题的风险。

第二步，在编辑操作中，【必须先添加「缩放」操作，再添加「裁剪」操作，顺序不能颠倒】。缩放的宽高都选择「URL 输入」，裁剪的宽高同样选择「URL 输入」。这样前端才能通过 URL 参数动态控制图片尺寸，例如：/wp-content/uploads/2024/01/photo.jpg?x-oss-process=image/resize,w_300,h_200,c_fill 才会正常生效。

保存后，系统会自动生成一段模板参数字符串，格式如 ~tplv-g7ckde5uoo-image:resize_width:resize_height:crop_width:crop_height.image。后续可将这段参数配置到 WPJAM Basic 插件中，以启用智能缩放功能，实现 WordPress 图片按需处理。

WordPress 后台对接 veImageX

确认已经安装并启用 WPJAM Basic 插件，然后进入 WordPress 后台，依次打开「WPJAM」→「CDN 加速」。

在云存储选项中选择「火山引擎 veImageX」，CDN 域名填写你已经绑定好的子域名（如 https://cdn.srrui.com），并开启图片设置开关。

在「图片设置」区域，把上一步生成的模板参数粘贴到「图片处理模板」输入框中，然后保存修改。

保存后，插件会自动重写媒体库中所有图片的 URL，将原本的 https://srrui.com/wp-content/uploads/... 统一替换成 https://cdn.srrui.com/wp-content/uploads/...?x-oss-process=... 这一类格式，方便通过 CDN 域名直接访问图片，同时自动附带对应的图像处理参数，提升 WordPress 图片加速与缩放处理效果。