播放授权

独立播放器（不经过飞牛网关、不登录本应用的设备或服务）无法使用普通中继地址。播放授权 为这类播放器提供一个专用只读通道：按目标颁发可撤销的授权密钥，把专用地址写入该目标的 STRM，播放器无需任何账号即可播放对应资源。

它与 应用授权 中的网盘流软件许可不同；软件许可必须有效，播放凭据不能替代。该功能默认关闭。通道只绑定你填写的单一 NAS 内网 IP 与端口，只提供播放，不提供管理功能，也不是通用网盘代理。

启用专用播放通道

1. 进入 播放授权。
2. 勾选 启用专用播放通道，填写 NAS 内网 IP 与未占用端口，例如 192.168.1.10:8766。仅允许单一内网 IP，端口需 ≥ 1024。
3. 点击 保存通道，等待状态变化：

状态显示	含义
正在监听 …	通道已就绪，可以创建授权
等待监听就绪	刚保存，稍等片刻并点击 刷新状态
端口绑定失败	端口被占用或地址无效，核对后重试；管理功能不受影响
外部播放未启用	通道关闭，已有授权地址不可播放

专用通道是 HTTP，仅限可信内网；不要把此端口映射到公网。NAS 防火墙是否放行、播放器能否实际连通，需要在设备上验证，保存配置不代表网络已可达。

通道配置随应用数据持久保存；应用重启后，若配置仍为启用状态，服务会自动重新监听该地址。

为目标创建授权

前提：目标已完成一次同步，且通道处于「正在监听」状态。

1. 在 目标播放授权 中选择目标。
2. 点击 创建或轮换目标授权，核对提示后点 确认并更新 STRM（该目标文件重写，旧授权立即失效）。
3. 页面临时显示 新授权密钥 · 仅本次显示。密钥已写入目标 STRM，无需另粘贴给播放器；按需 复制密钥 私下保存，再点 隐藏并清除。列表不回显，但 STRM 仍含播放凭据，不可外传。
4. 让下游应用重新扫描目标目录并实播一段，确认画面/声音、拖动和重新打开。保存通道或显示“已授权”不能单独证明播放已通。

界面示例（示例数据）：核对目标后，确认并更新 STRM，再让下游重新扫描。图中的监听状态与地址均为示例。

创建授权会校验目标生成目录的完整清单，把该目标全部 STRM 重写为专用地址，并撤销该目标旧授权；过程不访问、不修改 115 网盘。目标目录含手工添加或被修改的文件时会拒绝操作。

持有 STRM 即持有对应播放能力。请只向需要播放的下游共享生成目录，不要公开 STRM 内容或密钥。

撤销与轮换

• 撤销：授权列表中未撤销的授权可点击 撤销，立即阻止后续播放请求。已经交给播放器的 115 CDN 直链在其有效期内仍可能可用，撤销不能收回已开始的播放。
• 轮换：再次创建授权会重写目标 STRM 并撤销旧授权，用于密钥疑似泄露或地址迁移。
• 账号被停用／删除／须重置密码，或目标被删除时，其授权自动失效。

重新同步与地址变化

• 普通重新同步：目标带有效授权时，重新同步会复用同一密钥改写文件，无需重新授权；同步结果为空会撤销授权。
• 通道关闭时：带有效授权的目标会拒绝自动重新同步，需先开启通道或撤销授权。
• IP 或端口变化：旧地址授权作废，需逐目标重新创建授权并重写 STRM，再让下游重新扫描。

常见失败

现象	处理
创建授权按钮不可用	通道未启用或未就绪；先完成启用专用播放通道
播放返回「播放资源不可用」	授权已撤销、密钥或地址不符、目标被删除；重新创建授权
播放返回「播放请求繁忙」	并发请求过多，稍后重试
撤销后仍能播放一小段时间	已下发的 115 直链仍在有效期内；属预期行为
出现 .playback-pending 文件	上次发布被中断。停止自动重试，由部署维护者核对目标输出、备份与授权状态后恢复；详见故障排查