封面与切片加速

这一章讲「系统设置」里两项互相独立、但都影响图片加载与播放速度的功能:

两个页面都是「改完统一保存」:点击右上角「保存配置」才生效,「重新加载」会放弃未保存的修改。

封面图处理配置 #

采集的视频通常带远程封面。开启后,系统会在后台持续扫描视频,把可访问的远程封面保存为本地封面地址,前台展示时就不再依赖外部图片源。它影响视频管理中的视频卡片、详情页和播放页封面;不影响演员、合辑、发行商、广告图、区块图等你手动上传的图片。

开启步骤 #

1. 进入 系统设置 → 封面图处理配置;
2. 在「下载设置」里按下表填写,打开右上角的「启用」开关;
3. 按需开启「图片压缩」「图片转码」;
4. 点击「保存配置」;
5. 等待一段时间,到视频列表或前台查看封面是否已变为本地地址,并抽查清晰度、尺寸和格式。

下载设置 #

关于两个「删除」相关选项:

图片压缩与图片转码 #

重新下载全部图片 #

点击右上角的「重新下载全部图片」,会清空下载进度和失败记录,让系统从头检查并下载全部视频封面。适用于:

• 修改了压缩尺寸或转码格式,希望已有封面按新设置重新生成;
• 之前远程图片源异常,现已恢复,需要重新下载失败的封面;
• 之前配置错误导致大量失败,修正后重新处理。

前台效果与推荐配置 #

成功下载后,视频列表、详情页和用作分享图的封面都会使用本地地址;某个视频还没生成本地封面时,前台会继续使用原远程封面。

切片加速 #

切片加速只改写播放列表(HLS 索引)里的分片地址:把资源站域名替换为你自建的加速域名(Nginx 或 Cloudflare)。当资源站自身线路较慢时,可以在与资源站网络质量更好的服务器上部署固定上游的反向代理,播放器就通过加速域名请求分片、加密密钥和初始化文件。

使用时请遵守资源站的公开说明和采集 API 使用规则。切片加速只改变访问链路,不能用于绕过鉴权、防盗链或其它访问限制。

采集 API → HLS 地址 → 发财CMS 改写分片域名 → 你的加速代理 → 公开资源站

域名映射总控 #

切片加速需要订阅有效。未订阅时总开关、添加映射和保存都不可用,页面顶部会出现「立即订阅」入口。

映射规则 #

效果示例:

https://source-a.example.net/video/a/001.ts?token=demo
→ https://hls-a.example.com/video/a/001.ts?token=demo

会被替换的是播放列表里的绝对 HTTP/HTTPS 地址:分片或子播放列表、加密密钥地址、初始化文件。相对地址、协议/域名/端口与规则不一致、路径不在规则范围内、已停用的规则都不会被替换。

填写要点:

• 都要写完整的 http:// 或 https://;保存时自动去除首尾空格和末尾的 /;
• 协议、域名、非默认端口都是匹配条件,http:// 与 https:// 不互相匹配;
• 总开关开启时,至少要有一条完整规则才能保存;
• 多条规则同时匹配时列表中第一条生效,所以把更具体的路径规则放前面;
• 带路径前缀的映射(/media → /hls),要求代理端也把 /hls/ 固定转发到资源站的 /media/;
• 有多个资源站时,建议各分配独立的加速子域名,线路、超时和缓存策略可以分别调整,单个资源站故障也不影响其它入口。

使用前提 #

页面提示「点播加速未生效」时,先去开启「HLS 索引缓存」。它只保存处理后的播放列表,不缓存分片本身;要缓存分片,请在 Nginx、Cloudflare 等 CDN 里单独配置。

未拦截域名 #

总开关开启后,页面会记录「出现在播放列表里、但还没有配置映射」的资源站域名,帮你发现采集接口返回的备用线路或遗漏线路:

最多保留 100 个域名,超过后移除最久未出现的;服务重启后需要重新收集。「刷新记录」只更新这份记录,不会覆盖你尚未保存的规则;「清空记录」需要确认;保存新规则后,已被覆盖的域名会自动从列表消失。

推荐上线流程 #

1. 确认资源站免费公开、提供正式采集接口,并了解它的使用规则;
2. 为每个资源站准备独立的加速子域名;
3. 配置并验证 Nginx 到资源站的固定上游反向代理(见下),按需设置缓存;
4. 需要 Cloudflare 时,等 Nginx 验证正常后再开启橙色云和缓存规则;
5. 在后台添加映射规则,先只启用一条;
6. 打开总开关,点击「保存配置」;
7. 播放一个点播视频或直播,用浏览器开发者工具确认分片请求已经走到加速域名,并检查返回状态、Range、跨域和缓存命中;
8. 刷新「未拦截域名」,确认没有遗漏主要资源站,再逐步添加其它规则。

Nginx 反向代理示例 #

在加速域名的服务器上用 Nginx 固定转发到资源站(注意:proxy_pass 必须写固定上游,不要用请求参数拼接上游地址,否则会形成开放代理):

server {
    listen 80;
    server_name hls-a.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    server_name hls-a.example.com;
    ssl_certificate     /etc/nginx/ssl/hls-a.example.com/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/hls-a.example.com/privkey.pem;
    location / {
        if ($request_method = OPTIONS) {
            add_header Access-Control-Allow-Origin  "https://www.example.com" always;
            add_header Access-Control-Allow-Methods "GET, HEAD, OPTIONS" always;
            add_header Access-Control-Allow-Headers "Range, If-Range, Origin, Accept" always;
            add_header Access-Control-Max-Age 86400 always;
            return 204;
        }
        limit_except GET HEAD OPTIONS { deny all; }
        proxy_pass https://source-a.example.net;
        proxy_http_version 1.1;
        proxy_ssl_server_name on;
        proxy_ssl_name source-a.example.net;
        proxy_ssl_verify on;
        proxy_ssl_trusted_certificate /etc/ssl/certs/ca-certificates.crt;
        proxy_set_header Host source-a.example.net;
    }
}

需要替换:加速域名、资源站域名、证书路径、允许跨域的正式前台域名。Nginx 分片缓存、Cloudflare Cache Rules(静态分片可缓存、携带 Cookie/Authorization 的敏感请求绕过缓存)等进阶做法,请参考软件自带帮助文档的「切片加速」章节;配置后在前台实际播放一个视频,并用浏览器开发者工具确认分片请求已经走到加速域名。

常见问题 #