防劫持水印播放器
提示:由于功能会经常更新,如果你找不到相关功能选项,请更新到最新版后再使用。
播放器简介
播放器是一个独立的单文件程序,和EFV完全分离部署:可以装在另一台服务器上,也可以和EFV同机安装;支持N多水印和广告,适合使用秒切又想加水印广告的 或 想保护资源不被下载的使用。
功能说明
- 文字水印、图片水印、跑马灯广告,实时渲染,零转码。水印/文案由播放器在播放端实时叠加,位置自动贴合视频画面,横竖屏视频均自动适应;跑马灯支持自定义文案、位置、颜色,按时间循环从右向左横向滚动。
- 开屏、暂停、弹窗、四角图片、四角文字、跑马灯广告任意开启,弹窗、暂停样式对标主流视频
APP。打开播放页可全屏展示开屏广告,播放中可定时滑入弹窗广告,暂停时画面自动缩小展示广告,均支持设置展示时长、间隔与点击跳转链接,广告图横竖屏可分别设置。 - 防手机浏览器劫持,保障播放环境不被篡改,避免第三方浏览器在播放过程中跳转、替换或劫持播放内容。
- 支持
HLS双重加密防盗链。开启后,m3u8视频必须通过本播放器或自行对接解密逻辑才能播放,有效防止视频资源被下载、盗播,防盗链设置和对接 ⇒ 传送门 - 支持记忆播放、进度条缩略图预览。用户下次打开自动定位到上次观看进度;拖动进度条时可实时预览对应画面缩略图。
- 支持外挂字幕(
srt/ass/vtt)与自适应多分辨率切换。有多分辨率转码时播放器自动识别并支持手动切换清晰度,网络不佳时还会自动降档。 - 播放体验完整:手机端手势(单击播放暂停、双击快进退、长按
2倍速、横拖快进预览、竖拖调音量亮度)、倍速、截图、画中画、键盘快捷键等。
安装教程
系统要求:CentOS 8+,Debian 10+,Ubuntu 20.04+,AlmaLinux 8+,Rocky Linux 8+。
使用SSH客户端,比如Xshell软件,登录服务器,再使用命令:
curl -sSL https://down.querydata.org/efvplayer/install.sh | bash
安装完成后,会输出安装目录、运行端口和apikey。
绑定域名
提示:如果你服务器安装了宝塔面板,那就使用宝塔的NGINX进行绑定,反之推荐使用Caddy绑定
使用宝塔面板绑定
大致步骤,添加域名 ⇒ 申请免费SSL ⇒ 添加反向代理 ⇒ 修改反代配置,将以下代码全部覆盖即可
#12382为播放器端口,自行替换
{
proxy_pass http://127.0.0.1:12382;
proxy_set_header Host $host;
proxy_http_version 1.1;
}
还是不会的,可参考EFV的绑定教程 ⇒ 传送门。
使用Caddy绑定
提示:使用caddy绑定域名会自动申请免费SSL证书,运行前请先将域名解析到播放器服务器IP。
安装caddy(已安装可跳过):
wget --no-check-certificate -O '/tmp/install_caddy.sh' 'https://down.querydata.org/caddy/install_caddy.sh'
bash /tmp/install_caddy.sh
绑定播放器域名:
wget --no-check-certificate -O '/tmp/add_caddy.sh' 'https://down.querydata.org/caddy/add_caddy.sh'
#请将player.example.com改成自己的播放器域名、12345改成自己的播放器端口后再运行
bash /tmp/add_caddy.sh 'player.example.com@127.0.0.1:12345'
绑定命令可以重复运行,且每次运行都会重置绑定域名,如果更换播放器域名,可重复运行绑定命令。
绑定好了后,可直接打开播放器域名查看是否安装完成,且新安装的播放器会提示「请初始化播放器后再使用」,完成下面的EFV侧设置后会自动初始化。
初始化播放器
可点击EFV后台左侧的解析播放器设置,填写:
播放器域名:播放器的访问地址,如 https://player.example.com
apikey:安装播放器时打印的apikey,两边必须一致
填写后点击获取配置即可初始化播放器。
使用教程
播放
播放器唯一入口就是地址加上url参数,传入EFV的m3u8地址即可播放,也可以直接iframe嵌入到自己的网站:
https://player.example.com/?url=https://你的EFV域名/videos/xxxx/index.m3u8
地址参数
url:m3u8播放地址,必填,缺失会提示「缺少播放地址」
sub:外挂字幕地址,可选
thumb:进度条悬停缩略图接口,可选
debug:排障参数,加上后输出全量日志,报障用法见「常见问题」
对接HLS双重防盗链
首先前往EFV后台的防盗链/图片加密设置,开启HLS双重加密防盗链,然后再到解析播放器设置页,找到对接HLS双重防盗链,填入EFV绑定的域名地址即可。
配置好了后,解析播放器播放EFV的M3U8的时候,会自动解密HLS双重加密,达到播放目的;且这时候通过任何播放器播放都会播放失败,包括EFV后台的预览播放地址。
水印和广告设置
水印和广告均在EFV后台的解析播放器设置页配置,支持六种广告形态,广告图横竖屏可分别设置,保存后立即推送到播放器,无需重启。
常见问题
帮助完善播放器
播放器每次播放都会自动记录关键日志,如遇到播放失败、卡顿等问题,你可以定期提供一下日志,发给我们查看是否存在相关问题,并进行修复。
如何取日志:浏览器直接打开下面地址(域名换成自己的播放器域名,apikey为安装播放器时打印的),把打开的内容保存为文件即可:
https://player.example.com/report.log?key=你的apikey
把report.log文件发给我进行处理,也可通过邮件发送bted2k@gmail.com;日志不包含播放器或EFV域名、apikey等敏感信息,可放心发送。
反馈播放问题
提示:debug=1 只在排障时添加,平时观看无需添加。
使用中,如在某些浏览器里遇到播放失败、卡顿等问题时,请按下面步骤提供日志。
1、复现:在播放地址最后加上&debug=1,用出问题的那个浏览器再播放一次,让问题重现:
https://player.example.com/?url=https://你的EFV域名/videos/xxxx/index.m3u8&debug=1
2、取日志:浏览器直接打开下面地址(域名换成自己的播放器域名,apikey为安装播放器时打印的),把打开的内容保存为文件即可:
https://player.example.com/report.log?key=你的apikey
3、反馈:把report.log文件发给我进行处理,也可通过邮件发送bted2k@gmail.com;日志不包含播放器或EFV域名、apikey等敏感信息,可放心发送。
迁移服务器
如果你想在其它服务器安装播放器,又不想重新配置水印等信息,可在新服务器使用脚本安装后,把旧播放器的以下文件覆盖到新服务器相同位置(安装目录下的web内):
web/assets
web/.upstream
web/player-cfg.json
以上包含水印广告图片、水印广告配置、防盗链对接的EFV域名,覆盖后即无缝迁移旧播放器所有设置项,包括水印图片等;当前如果你安装了多个播放器,想共用这些信息,也可以覆盖到多个播放器目录。
但是apikey这个不会跟着迁移,也就是每次新装的apikey会不一样,记得在EFV后台的解析播放器设置页配置填入新的apikey,再点击一次获取配置;这一步还会顺带完成新播放器的初始化,首次打开播放器出现的「请初始化播放器后再使用」提示也会随之消失,并且获取到的配置正是刚迁移过去的水印广告配置,可顺便确认迁移成功。
卸载
systemctl disable --now efvplayer-server
rm -rf /opt/efvplayer /etc/systemd/system/efvplayer-server.service