音视频上传播放
帖子与回复中上传并内嵌播放本站音视频:按用户组限制格式/体积/每日条数与总量,可选同步到 Cloudflare R2,前台地址与取流都直连 R2 公开域名(媒体带宽不过本站),PC 固定 400px、移动端 350px,滚动离开自动暂停。
Author
folcc Verified developer
Downloads5
Min core version1.2.0
Updated2026-10-27 15:25
Log in to download
Log in to download the package directly — for servers that cannot install plugins online.
After downloading, upload the zip in your own site admin: Plugin Store → Upload & Install. If your server has outbound access, prefer the online install — it can auto-update.
Screenshots 3
Changelog
2.1.0 修复(代码审计):① 播放取流缺版块权限(高危)—— /media-player/stream/{id} 与 /media-player/embed/{id} 原先只判 backend 与总开关,而 fhmp_media.id 是自增整数,任何人(含未登录访客)遍历 id 就能把私密版块的音视频整批拉走。现补一道 canPlay():category_id 缺失一律拒绝,再按核心 AttachmentController::download() 的口径判 can_view(未登录按游客组)。只判 can_view、不判 can_attach —— 播放是「看」不是「传」,把后者也加进来会让后来被收回附件权的用户组连自己以前传的视频都播不了(若升级后个别老文件报 403,多半是记账里 category_id 为 0 的历史行,核心对「附件无有效版块归属」同样拒绝,后台删掉重传即可)。② 卸载不删主密钥 —— 核心 Plugin::uninstall() 明确「保留插件目录及文件」,data/secret.key 会一直留着,而 settings 里的密文已被清空,重装时会静默沿用旧密钥;现卸载流程补删该文件(主密钥走 env / config.php / protected/ 三种来源时文件本就不存在,is_file() 自动跳过)。③ 用户组限额零改动保存时提示静默消失 —— AdminController::groups() 会发 msg=nochange,三语字典里 msg_nochange 都在,视图的 msg 分支却漏了这一条;现补上,与 save() 的 err=nochange 报错口径对齐。④ 语言包新增 plugin.media_player.embed_denied(三语各 158 键、键序一致)。⑤ 版本号 1.1.0 → 2.1.0:同时高于历史 1.5.4,不再触发下面那条「已装 1.5.x 的站点会把 1.1.0 判成降级」的问题。功能、路由、表结构一律未变。1.1.0 变更:① 版本号归号——本版功能内容承接 1.5.4(作者署名 folcc),只把版本标识从 1.5.4 改回 1.1.0(plugin.json 的 version、各文件头部 @version、说明.md 版本行与更新记录标题);下面 1.5.4 一条保留作历史编号,本条取代文件末尾那条旧 1.1.0(用户组限额 + R2 集成,已随归号并入本版)。② 默认不启用:plugin.json 的 activated 由 true 改为 false,装完只是「已安装、未启用」,要到后台「插件管理」点「启用」才注册路由与钩子;表在点启用时才建(activate() 调 ensure()),未启用期间前台不注入上传按钮、正文里的播放器也不渲染,路由 /media-player/upload 直接 404。已装过 1.5.x 的站点注意:核心升级时会保留本地 activated 值(PluginUpdater::PRESERVE_KEYS),这一项只对全新安装生效。③ 后台「连接配置」两处示例文案去 flinthub 字样:存储桶名称「如 flinthub-files。」→「如 folcc-files。」、存储目录「桶内相对目录如 flinthub」→「如 folcc」(繁中/英文同步)。功能、路由、表结构与校验链一律未变。注意:若站点已装过 1.5.x,1.1.0 在版本比较里是降级,后台可能拦下或提示回退;覆盖安装前先在插件管理确认版本号,必要时先卸载再装(fhmp_media 与 fhmp_group_limits 两张表不动、assets/uploads 里的文件不动、R2 设置不丢)。1.5.4 变更:插件作者署名由 FlintHub 改为 folcc(plugin.json 的 author 字段,后台「插件管理」列表显示的就是它)。代码里没有其它作者引用(各文件头部的「FlintHub 插件」说的是平台,不是作者),功能、路由、表结构、文案一律未动。1.5.3 修复 + 变更:① 1.5.2 那条红色提示在屏幕上显示成原始键名 js.media_player.need_category —— 脚本里的键名与语言包里的 js.media_player.no_category 对不上,核心 __t() 取不到就回吐键名。两边统一为 no_category,文案定为「请先选择分类」(繁中「請先選擇分類」、英文 Choose a category first.)。② 上传流程的提示改挂到编辑器容器上并居中:toast(msg, type, anchor) 多一个锚点参数,锚点取核心 ACTIVE_EDITORS[id].container(即 .editor-container),CSS 新增 .fhmp-anchor 提供定位上下文、.fhmp-toast--in-editor 定在框子正中;覆盖未选分类 / 文件过大 / 网络异常 / 未登录 / 服务端报错 / 插入成功六种提示,拿不到容器时才退回视口底部。锚点刻意不是 .editor-editable —— 那是 contenteditable,提示写进去会被当成正文一起存下来。位置一律走 class 切换,不写内联 style(§7.3)。无服务端改动、无表结构变更。改了 assets/script.js 与 assets/style.css,覆盖后浏览器要硬刷新一次。1.5.2 变更:先确认版块,再开始上传。① 前端闸门 requireCategory():发帖/编辑页还没选版块就点上传按钮时,文件选择框压根不打开,只提示「请先选择所属版块」并把那个下拉框聚焦、滚到视口中间 —— 原先是用户选完文件、把几百 MB 传上去之后才收到一句「缺少所属版块」,带宽和等待全白花。② 服务端把版块判定(category_id 有值 + Category::find() 真实存在 + Permission::canAttach())提到 $_FILES 处理之前:非法版块的请求不再读文件、不占每日条数与容量配额、不落盘、不推 R2;但说清楚,PHP 在进控制器前就收完了 multipart 请求体,「字节不到服务器」只有前端闸门能做到。③ 一批文件共用点按钮那一刻取定的版块 id(runQueue() 多收一个参数,uploadFile() 不再每条重读下拉框),中途改版块不会把同一批文件分到两个版块。语言包 ×3 各加 1 个前端键 js.media_player.no_category(各 157 键、键序一致)。无新路由、无表结构变更。1.5.1 修复:正文里已经是 R2 公开地址、前台却只剩普通链接(播放器整个不出现)。这条分支原先只认 prefetchR2() 那一次整屏预取,漏掉就没有第二次机会(这一屏媒体链接超过 400 个占位符 / 500 行上限,或正文来自不走 controller_view_before 的字段),而且失败完全静默 —— 本地地址那条有磁盘副本兜底,所以同一处漏查在 1.4.x 根本看不出来。现在漏查时按 r2_key 等值补查一行(新增 r2RowByKeyLookup(),整请求最多 2 次,查不到的键进负面集合不再追问),与预取合计仍在 §11.4 的 5 次查询上限内;确认记账表里没有这个对象键时写一行 error_log(media_player resolve: no ledger row for r2 key …),让「文件压根没进 R2(多半超过了进入 R2 的单文件上限,去文件列表补推)」和「渲染没走到这一步(清 data/runtime/pages/)」在日志里一眼分开。无新路由、无表结构变更、无文案变更。1.5.0 变更:前台地址改用 R2「公开访问地址」。上传推 R2 成功且配了公开地址时,编辑器插进正文的就是它(原先恒为 /assets/uploads/…),播放器下方的下载链接同样优先给它;渲染期两种地址都认(公开地址按对象键查记账行,查不到就原样当普通外链,绝不拿陌生 https 去播);iframe 文档里媒体元素的 src 也直接用它(永不过期),没配公开地址才现签 24 小时的端点地址。「播放源」两项重定义:默认「远端优先」= 记账里有 R2 归属就出 iframe 直连,本地那份只当兜底;新增「本地优先」= 旧的 auto 行为(本地副本读得到就播本地);老值 r2 归一成远端优先。「测试连接」新增一次无签名公开读(?pub=ok|bad),桶没开公开读时直接在后台报警,不再出现「测试是绿的、前台是黑的」。1.4.0 新增:播放直连 R2。核心给每个页面发的 CSP 是 default-src 'self' 且未放行 media-src,跨源 video 必被浏览器拦掉,而插件改不了那个响应头;但 CSP 只约束「发它的那份文档」,frame-src 又回落到 'self' —— 于是新增 GET /media-player/embed/{id}:一份同源极简文档,自带只放行 R2 主机名的 CSP、no-store、SAMEORIGIN,里面是 src 指向 SigV4 查询串签名地址(R2Client::presignGet,24 小时有效)的 video/audio;正文改嵌 iframe(loading=lazy、allowfullscreen),字节由浏览器直接向 R2 要,本站只出这一份文档。iframe 内不放脚本,滚动离开自动暂停由父页脚本读同源 contentDocument 完成。原中转 /media-player/stream/{id} 退居兜底(R2 参数不齐时)与「下载」链接,并补上 Vary: Range —— 修掉开启 PWA 时核心 sw.js 的 Cache-First 把第一窗 206 回给后续不同 Range 请求、导致只能播开头 4 MiB 的问题。resolve() 多返回 frame 与 dl;后台「播放源」两项文案随之重写。1.3.0 新增:后台「文件列表」页的「补推到 R2」。同步模式只在上传那一刻生效,配好 R2 之前上传的文件归属仍是 local,改设置对它们无效;这个动作按当前配置把它们补推一份到远端并改记为 both,永不删除本地副本(主存储模式也只对之后的新上传生效)。一次请求只推一批(最多 25 个 / 20 秒)以免同步请求超时,推完回报成功、失败、本地副本缺失、超过单文件上限与剩余待补推条数;超过上限的文件单独计数,不再混在「待补推」里让按钮永远消不掉。1.2.1 修复:文件已进 R2 而前台仍指向本地地址、导致播放器整个消失。播放源不再只看「主存储模式」——本地副本读不到时(主存储上传后即删、副本模式被清盘)一律回落到同源中转 /media-player/stream/{id};中转路由同时接受 backend=both;预取不再被 R2 开关短路,开关关掉时给出可诊断的中转失败而不是静默丢播放器。新增「播放源」设置(本地优先 / 一律走 R2),副本模式下也能让前台直接走 R2 中转。1.2.0 变更:R2 后台改为「连接配置」单页布局(账户 ID / 存储桶名称 / 公开访问地址 / 存储目录 / 访问密钥 ID / 机密访问密钥),请求地址直接由账户 ID 拼出,移除自定义 Endpoint 与 Region 输入;新增加密密钥来源与指纹展示、连接状态徽章;连接测试改为上传并读回 flinthub-test/test.txt(可按未保存的表单值直接测)。1.1.0 新增:按用户组覆盖单文件体积/每日条数/每日总量/格式白名单,集成 Cloudflare R2 存储与同源 Range 中转播放。
Files 23 325.8 KB
-
plugins
-
media_player
-
assets
- admin.css 5.7 KB
- admin.js 1.4 KB
- embed.css 1.3 KB
- script.js 19.1 KB
- style.css 5.4 KB
-
hook
- admin_route_register.php 912 B
- controller_view_before.php 3.7 KB
- init_after.php 1.1 KB
- layout_body_end.php 2.6 KB
- layout_head_end.php 2.3 KB
- route_register.php 1014 B
-
lang
- en.php 17.7 KB
- zh.php 17.3 KB
- zh_tw.php 17.1 KB
-
views
- admin.php 35.2 KB
- AdminController.php 17.2 KB
- FrontController.php 29.1 KB
- MediaRenderer.php 8 KB
- Plugin.php 58.8 KB
- R2Client.php 17.4 KB
- SecretBox.php 6.3 KB
- plugin.json 11.2 KB
- 说明.md 46.3 KB
-
-
Discussion 0
No discussion yet. Be the first to share your thoughts.
Please sign in to join the discussion.