简介
基于 CloudFlare Stream 在 WordPress 中实现视频上传、管理和播放。
Cloudflare Stream 是 CloudFlare 提供的视频托管和流媒体服务。上传视频后，CloudFlare 自动完成转码处理，生成自适应码率的 HLS 流，通过全球 CDN 分发。Mine CloudVod 集成了 CloudFlare Stream，让你可以在 WordPress 区块编辑器中直接上传和管理 Stream 视频。
优点
- 零配置转码：视频上传后自动转码为多码率 HLS 流，无需手动配置转码模板
- 按量付费：只收存储费用和流媒体时长费用，无转码费、无隐藏费用
- 全球 CDN：基于 CloudFlare 全球网络，播放体验优秀
- 签名 URL：支持 requireSignedURLs，保护视频内容不被盗链
- TUS 可恢复上传：支持断点续传，大文件上传更稳定
缺点
- 上传管理操作在境内可能较慢
- 国内访问速度可能受限，建议搭配自定义域名使用
准备工作
- 注册 CloudFlare 账号
- 在 CloudFlare 后台启用 Stream 服务（进入 Dashboard → Stream → 激活即可）
后台设置
第一步：获取 API 凭证
有两种认证方式，推荐使用 API Token：
方式一：API Token（推荐）
- 进入 CloudFlare 后台 → 右上角头像 → 我的个人资料 → API 令牌
- 点击「创建令牌」→ 选择「创建自定义令牌」
- 权限配置：
- 权限：
Account — Stream — Edit - 资源：
包括 — 特定账户 — 你的账户
- 权限：
- 创建后复制生成的 Token
💡 使用 API Token 时，不需要填写 Email 和 API Key 字段。
方式二：Global API Key（兼容方式）
- 进入 CloudFlare 后台 → 右上角头像 → 我的个人资料 → API 令牌
- 在「Global API Key」旁点击「查看」，输入密码后复制 Key
- 同时记下你的 CloudFlare 注册邮箱
Account ID 获取：
Account ID 可以在 CloudFlare 控制台首页右侧找到，也可以从任意 API 请求的 URL 中获取（格式如 https://dash.cloudflare.com/xxxxx 中的 xxxxx 部分）。
第二步：填写密钥配置
进入 WordPress 后台 → Mine云点播 → 设置 → 找到「CloudFlare」标签 → AccessKey 设置：
| 字段 | 说明 |
|---|---|
| CloudFlare EMail | 方式二时填写 CloudFlare 账号邮箱；方式一可留空 |
| Account ID | 你的 CloudFlare 账户 ID（必填） |
| API Key | 方式二时填写 Global API Key；方式一可留空 |
| API Token | 推荐填写此项。如果填写了 API Token，Email 和 API Key 可以留空 |
⚠️ 插件会自动识别 API Key 字段中填写的是 API Token 还是 Global API Key（通过格式判断：37位十六进制为 Global Key，否则视作 Token）。
填写后点击 保存。
使用方法
区块编辑器
- 在文章编辑页面，点击添加区块（+号），搜索「CloudFlare」或从 Mine 分类中找到它
- 插入区块后，会显示两个按钮：
- 添加/选择 Stream — 使用 CloudFlare Stream 视频
- 添加/选择 R2 — 使用 CloudFlare R2 存储的视频
- 点击「添加/选择 Stream」，弹出视频管理窗口：
- 在视频管理窗口中可以：
- 📋 浏览视频列表：查看已上传到 CloudFlare Stream 的所有视频
- 🔍 搜索视频：通过关键字搜索视频
- 📤 上传新视频：拖拽或点击选择本地视频文件上传（支持 TUS 断点续传）
- 🗑️ 删除视频：点击视频可查看详情，支持删除操作
- 选择视频后，视频将插入文章，编辑器内会显示播放器预览。
播放器设置
选中视频区块后，在右侧设置面板中可以调整：
| 设置项 | 说明 |
|---|---|
| 视频标记 | 在视频时间轴上添加标记点，方便跳转到关键内容 |
| 价格 | 设置付费观看价格和预览时长 |
| 仅登录可看 | 开启后，只有已登录用户才能观看此视频 |
| 自动播放 | 页面加载后自动开始播放 |
| 宽度 | 播放器宽度，默认 100% |
| 高度 | 播放器高度，默认 auto（自适应高度），也可指定固定值如 500px |
| 封面图 | 自定义视频封面图片，可输入 URL 或从媒体库选择 |
经典编辑器
在经典编辑器中，点击「Mine云点播」图标 → 选择「CloudFlare」标签页 → 选择或上传 Stream 视频 → 点击插入。
短代码
你也可以在文章中使用短代码插入视频：
[mcv_cloudflare vid="视频ID" width="100%" height="auto"]
💡
vid可以从视频管理窗口或 CloudFlare Stream 后台中获取。
视频管理
上传视频
支持两种上传方式：
- 区块编辑器内上传：插入 CloudFlare Stream 区块 → 点击「添加/选择 Stream」→ 在弹窗中拖拽或选择本地视频文件
- 直接在 CloudFlare 后台管理：登录 CloudFlare Dashboard → Stream → 上传视频
TUS 可恢复上传
插件使用 TUS 协议上传视频，支持：
- 断点续传：上传中断后可以继续，不会从头开始
- 大文件支持：适合上传较大的视频文件
- 上传进度：实时显示上传进度
上传时默认开启 requireSignedURLs，确保视频只能通过签名 URL 访问，防止盗链。
搜索和浏览
在弹窗中可以通过关键字搜索视频，支持分页浏览。搜索结果直接来自 CloudFlare Stream API。
常见问题
插入了视频但前端不显示播放器？
请检查：
- CloudFlare API 凭证是否正确填写（特别是 Account ID）
- 视频是否已完成转码（新上传的视频需要几分钟处理时间）
- 如果开启了「仅登录可看」，确认用户已登录
上传视频报错？
可能原因：
- API Token 权限不足：需要
Account — Stream — Edit权限 - 网络问题：CloudFlare API 在境内访问可能较慢，建议使用境外服务器操作
- 文件格式不支持：CloudFlare Stream 支持常见视频格式（MP4、MOV、AVI 等）
如何保护视频不被下载？
- 在 CloudFlare Stream 设置中启用
requireSignedURLs - 在区块设置中开启「仅登录可看」
- 可以绑定自定义域名并开启防盗链
费用如何计算？
CloudFlare Stream 按以下维度计费：
- 存储：按分钟存储的视频时长计费（每月 $5/1000 分钟）
- 流媒体：按观看时长计费（$1/1000 分钟观看）
相关资源
后台设置
