Yctvn Media Offload使用教程 | 新手零基础，WP图片直传Cloudflare R2，无需复杂配置

2026年3月4日 22点热度 0人点赞 0条评论

插件简介

Yctvn Media Offload for Cloudflare R2是一款专为WordPress设计的轻量插件，无需依赖S3兼容层，原生对接Cloudflare R2对象存储服务，核心功能是实现WordPress媒体库文件（图片、视频等）上传时自动同步至R2，同时自动替换媒体URL为R2地址，彻底解决服务器存储占用过大、图片加载速度慢的痛点。该插件操作简洁、无冗余功能，适配所有主流WordPress版本，兼顾新手与资深用户需求，无需复杂代码配置，全程可视化操作，支持批量同步旧媒体文件、自定义CDN域名、上传后删除本地文件等实用功能，完美适配Cloudflare R2的免费额度与特性，是个人站长、小型网站实现媒体文件上云的优选插件，搭配Cloudflare R2的全球节点，可大幅提升图片加载速度，同时享受免费存储与安全防护优势。

核心参数

1、支持平台：适配WordPress 5.0及以上版本，兼容所有主流主题与插件，无版本冲突风险。

2、硬件要求：无额外硬件要求，依托WordPress所在服务器配置，主流虚拟主机、云服务器均可流畅运行。

3、核心功能：自动上传媒体至R2、URL自动替换、批量同步旧媒体、自定义CDN域名、本地文件删除（可选）。

4、插件特性：轻量无冗余、无捆绑插件、可视化配置、支持R2公开访问/自定义域名、兼容R2 API令牌权限。

5、权限要求：WordPress后台管理员权限（用于插件安装、配置），R2 API令牌需具备Object Read & Write及List buckets权限。

核心功能亮点

原生适配Cloudflare R2

无需额外配置S3兼容参数，直接对接Cloudflare R2 API，规避兼容层导致的上传失败、URL替换异常等问题，适配R2的Auto区域存储、公开访问、自定义域名等所有核心特性，搭配R2每月10GB免费存储空间，个人用户可免费使用核心功能。

自动上传与URL替换

开启自动上传功能后，WordPress媒体库新上传的所有文件（图片、视频、文档等）会自动同步至R2，同步完成后自动替换媒体URL为R2地址（或自定义CDN域名地址），前端页面直接从R2加载媒体，无需手动修改链接，提升加载速度的同时节省服务器带宽。

批量同步旧媒体文件

支持手动批量同步WordPress媒体库中已有的旧文件至R2，可设置同步批次大小，避免单次同步过多文件导致超时，同步完成后自动更新旧文件URL，无需手动逐个修改，轻松实现旧媒体文件上云迁移。

灵活自定义配置

可自由选择是否删除本地文件（节省服务器空间），支持配置R2自定义CDN域名，适配Cloudflare R2的域名绑定功能，避免使用默认R2地址的速率限制，同时可设置上传模式（仅原图/所有尺寸），适配不同使用场景。

轻量稳定，易上手

插件体积小，不占用过多服务器资源，无冗余功能，配置界面简洁直观，所有核心选项一目了然，新手无需学习复杂教程，按提示填写R2相关信息即可完成配置，同时支持调试日志（按需开启），方便排查上传、同步异常问题。

使用教程（全程可视化，无代码）

第一步：前期准备（必做）

1. 登录Cloudflare控制台，进入R2页面，创建存储桶（Bucket），命名建议为wp-media-r2（小写字母+数字，无特殊字符），区域选择Auto；2. 生成R2 API令牌，权限选择Edit（包含Object Read & Write、List buckets），保存好Access Key ID、Secret Access Key、Account ID；3. （推荐）给存储桶绑定自定义域名，进入Bucket→Settings→Public access→Connect Domain，输入二级域名（如img.yourdomain.com），等待状态变为Active；4. 确保WordPress版本≥5.0，且拥有后台管理员权限。

第二步：插件安装与激活

1. 登录WordPress后台，进入「插件→安装插件」，搜索「Yctvn Media Offload for Cloudflare R2」；2. 找到插件后点击「安装」，安装完成后点击「激活」；3. 若后台搜索不到，可从官方仓库下载插件ZIP包，通过「上传插件」功能上传至wp-content/plugins目录，解压后激活即可。

第三步：核心配置（关键步骤）

1. 激活后，在WordPress后台左侧菜单找到「Yctvn R2 Offload」，进入插件配置页面；2. 对照前期准备的R2信息，依次填写以下必填项：Cloudflare Account ID（你的R2账户ID）、Access Key ID（R2访问密钥公钥）、Secret Access Key（R2访问密钥私钥，完整填写，切勿脱敏）、R2 Bucket Name（创建的R2存储桶名称）、Custom Domain (CDN)（绑定的自定义域名，无则留空）、Region（固定填写auto）；3. 勾选核心功能选项（推荐配置）：Auto Offload New Media（自动上传新媒体）、Enable URL Rewrite（URL自动替换）、Auto Fix Thumbnails（自动修复缺失缩略图）；4. 可选配置：Delete Local Files After Upload（上传后删除本地文件，建议配置稳定后开启）、Batch Size（同步批次，默认10即可）；5. 点击「Save Changes」保存配置，再点击「Test Connection」测试R2连接，显示Success即配置成功。

第四步：核心操作（上传+同步）

1. 新媒体上传：进入「媒体→媒体库→添加新文件」，上传一张测试图片，上传完成后点击图片编辑，查看文件URL，若显示为R2地址（或自定义CDN域名地址），则自动上传生效；2. 旧媒体同步：进入插件配置页面，找到「Bulk Sync Media」，点击「Run Bulk Action」，批量同步已有的旧媒体文件至R2，同步进度可在页面查看；3. 异常排查：若上传/同步失败，可临时开启「Enable Debug Logging」，查看错误日志，针对性解决（如API密钥错误、R2权限不足等）。