Provider 管理

Provider instance 是 SyncTV 连接远程 Provider gRPC 服务的实例配置，只保存 endpoint、TLS、JWT secret、custom CA、timeout 和该远程服务声明支持的 Provider type。上游媒体源账号、token、cookie、UA 或特定后端参数属于用户 Provider 凭据或远程 Provider 服务自己的部署配置，不属于这里的 instance 配置。

远程 Provider instance 当前可声明的 Provider type 是 alist、bilibili、emby。媒体源自身还包含本地类型 direct-url、rtmp、live-proxy，这些不是远程 Provider instance 的 --provider 值。

常见操作

synctv provider available
synctv provider list
synctv provider create <NAME> <PROVIDER_ENDPOINT> --provider alist
synctv provider update <NAME> --provider-endpoint <PROVIDER_ENDPOINT> --provider alist
synctv provider enable <NAME>
synctv provider disable <NAME>
synctv provider reconnect <NAME>
synctv provider delete <NAME>

操作前检查

操作	先确认
创建	endpoint、TLS/JWT/CA 配置正确，声明的 --provider 在远程服务支持范围内
更新	新旧 endpoint、TLS、JWT secret、CA、timeout 和支持的 Provider type
禁用	当前是否仍有用户默认 Provider 或房间媒体依赖
删除	是否仍被播放列表、用户偏好或远程实例引用
重连	上游是否可达，凭据是否过期

播放验证

修改 Provider 后，至少验证：

1. 管理员账号可以浏览或搜索媒体。
2. 普通用户能按权限看到可用媒体。
3. 直连播放和代理播放都符合预期。
4. 支持 Range 的上游可以 seek。
5. Bilibili、Alist 等对 header 敏感的来源使用了正确的 User-Agent、Referer、Range 和认证 header。

媒体源概念见 媒体源；用户接入步骤见 添加媒体。