FlixMedia · 管理
面板对接
FlixMedia 和 FlixPilot 面板如何配合：能力、账号规则和路径约定。
FlixMedia 和 FlixPilot 面板是两个进程（通常是两个容器），靠 HTTP 对话。部署方法见部署指南。
接了面板能多什么
| 能力 | 说明 |
|---|---|
| 账号 | 面板账号可以直接登录 FlixMedia |
| 授权 | 面板激活后，FlixMedia 自动激活 |
| 网盘直链 | 网盘文件播放时向面板换直链，直接 302 给播放器 |
| TMDB | 没在 FlixMedia 里填密钥时，用面板的配置 |
| 媒体运维 | 在面板的「媒体运维」页面管理 FlixMedia |
| 增量扫描 | 面板转存、备份、STRM 同步、归档完成后，通知 FlixMedia 扫描有变动的目录 |
内部密钥
面板启动时在数据目录生成 mediaserver-internal.token，双方都用它互相认证。FlixMedia 有自己的数据目录，把这个文件单独只读挂进去即可。文件不存在时 FlixMedia 视为「面板尚未就绪」，登录等操作会返回错误。
账号规则
FlixMedia 有自己的用户系统（接口和 Emby 一致）。
- 登录顺序：先查本地用户；本地没有或密码不对，且接了面板，再让面板校验。面板校验成功就同步成本地用户（同名用户沿用已有的本地 id，保住观看记录），以后面板不在也能用同一个密码登录。
- 面板里改了密码：下次用新密码登录时，面板校验通过，本地密码随之更新；面板不可用期间旧密码仍可登录本地。
- 管理员由本地用户的「管理员」标记决定；面板账号每次通过面板登录时按面板的角色更新。
- 同一用户名 + IP 10 分钟内失败 8 次会被暂时锁定。最后一个可用的管理员不能被删除、降级或停用。
- 没接面板且没有任何用户时，网页登录页会变成「创建管理员」（建完就关闭，不能重复用）。
- 同一个账号在播放器里和网页里登录，得到的是 FlixMedia 自己签发的令牌，面板重启不会让它们失效。
单机模式（没有面板）
没有内部密钥文件、API_UPSTREAM 连不上时，FlixMedia 视为单机：用户只靠本地；TMDB 默认走中转（不用申请密钥；FLIXMEDIA_TMDB_RELAY=off 可关闭）；想用自己的密钥 / 接口地址 / 出站代理，在「设置 → 元数据」里填；依赖面板的网盘直链、秒传校验、strm 触发不可用（本地文件和 STRM 正常）。接了面板时，设置里填了 TMDB 密钥就以这里的为准，留空则用面板的。
路径约定
STRM 文件里写的是路径或网址。媒体库路径、STRM 内容、面板的路径映射三处必须用同一套容器内路径（例如 /strm、/CloudHub/...），否则 302 直链和扫描会找不到文件。