故障排查

先保留版本、操作步骤和实际错误，再对号处理。普通重试不需要删除数据、卸载或重建账号。反馈截图先遮住 Cookie、播放密钥、私有地址与账号信息。

打不开应用或 404

现象	处理
没收到初始管理员账号	向安装维护者取得系统初始化的账号；当前没有网页自助领取入口
登录已失效	重新登录；当前新会话期限 30 天，退出、改密或账号变更可以提前撤销，旧版本已发会话不自动延长
登录失败过多	同一用户名 5 分钟内错 10 次，等待后再试
请先修改初始密码	首次或管理员重置后到我的账号完成改密并重新登录，见首次登录
NAS 入口没有或未读取到身份	Docker 不提供该入口；飞牛从桌面正常入口重开，或用应用密码
NAS 身份已变化/解绑/停用/删除	重新读取身份，或用已有应用密码/联系管理员；反复确认不会绕过账号限制
NAS 账号没有密码登录	应用管理员用户管理 → 重置密码后，本人用本地用户名和新初始密码登录改密
忘记密码	成员请应用管理员重置；唯一管理员先保留数据联系维护者，无自助找回，不直接用旧备份覆盖现状

先在 应用授权 核对实际期限、网络和系统时间。已有支付查原订单；平台连接、付款与本机安装许可分别核对。许可失效会影响同步、目录读取和两类播放，专用播放密钥不能绕过。按软件授权与恢复使用原购买账号或匹配文件，不反复下单。

现象	处理
保存凭据被拒	完整 Cookie 需有 `UID`、`SEID`，无换行、控制字符或重复字段
已保存但读不出目录	本地保存不证明有效。看本次错误，核对过期、账号和 115 上游限制，更新后再打开目录
无法连接 115	检查 NAS 出网与上游服务，稍后重试
返回目录不完整	应用会拒绝不完整结果以保护输出；保留错误，稍后重试，不把它当完整空目录
不知道如何取得 Cookie	当前没有扫码/自动获取入口；先准备自己账号的合法有效凭据，不向他人索要账号或贴出凭据

先看 运行记录 中具体说明：

说明（示例）	处理
单目录超过 500 项	在 115 拆分目录或分别对小子目录建目标；50 项浏览分页不提高同步上限
未配置 Cookie/服务地址	完成网盘凭据与服务地址，再创建目标
3DVR 重名视频	文件名需不区分大小写也唯一，先整理源目录
目标目录异常文件/已修改	先备份，交维护者核对生成清单和手工文件；不直接删整个目标或清单
另一项同步/删除进行中	等终态；浏览器超时先刷新记录，后台操作不会因关页取消
上游拒绝	检查 Cookie、账号状态与实际错误，上游限制时稍后再试

读取/新文件生成阶段失败会保留旧输出；修复后对原目标 重新同步。如果提示输出已切换、备份清理失败或恢复标记，不能假定所有文件都未改变，先按下面流程保留现场。

现象	处理
下游扫描就报 401	探测发生在播放之前；先配专用播放授权并更新 STRM，再让下游扫描
普通中继返回 401	下游没有本应用会话，用专用播放授权，不发送管理员密码/Cookie
专用资源不可用	核对软件许可、通道状态、目标/颁发账号和授权是否仍有效；地址变化需轮换授权
播放请求繁忙	并发过多，稍后重试
已列出媒体但打不开	看下游实际错误、格式兼容与直链可达性；目录成功不保证播放
中途卡顿	同时检查 Cookie、NAS 到 115 的换链请求，以及播放器到 CDN 的网络；不一律归因网盘流
修改地址后仍走旧地址	重新同步普通地址目标；专用 IP/端口变化重新授权，再让下游重新扫描

看到下列残留时，先停止相关写入并保存应用数据、输出与运行记录，交部署维护者核对，不直接删除：

内容	含义与处理
`.backup-…`	上次替换保留的旧输出；未处理时拒绝后续同步/删除，须与当前目标对比
`.sync-…`	暂存输出；名字本身不能证明可删，先核对是否活动运行/恢复仍需要
`.playback-pending-….json`	播放授权发布未完成；须一起核对目标文件、授权状态和备份，不手动清标记后盲重试

当前没有自动完整回收/一键恢复界面。恢复以维护者核对的完整现场为准，不猜测哪套文件才是最新。

保留当前数据与原备份，确认仍使用原数据目录、私有配置及正确权限。由维护者按备份与恢复处理，恢复后核对用户、目标、许可与实际播放；不能把复制成功当作恢复成功。不要清空用户表、换密钥或重新生成安装身份。