1. 设备与上线
设备一直不上线，设备列表里没有
- 确认设备侧 ACS 地址是否填写为
http://<服务器IP>:9090/，
并确认设备能 ping 通服务器（设备与管理网段是否可达）。
- 确认服务器 9090 端口已在防火墙 / 云安全组放行，且服务确实在监听。
- 检查设备侧的 ACS 用户名与密码是否与平台要求一致。
- 让设备重新触发一次上报（重启设备或等待其周期上报），再刷新列表。
设备曾经在线，现在掉线了
- 先看列表中的「最后汇报」时间：时间越旧，说明设备停止上报越久。
- 确认是否发生过网络变更、设备断电、上层网络中断。
- 若大批设备同时掉线，优先怀疑服务器侧（服务进程、端口、网络），
而不是逐台排查设备。
- 服务重启后设备会集中回连，在线状态可能短暂显示滞后，等待几分钟后自动收敛。
免费额度是多少？纳管数量到上限怎么办
系统出厂即为免费版，内置永久免费额度：可管理光猫 10 台、
可管理 OLT 1 台、单台 OLT 可注册 ONT 10 个（三组额度互相独立、
无到期日）。免费额度只限制新增，已在管的设备不会被回溯锁定。
超出免费额度后，在「系统设置 → 系统授权」查看名额使用情况（已占用 / 上限 / 超限台数），
超出上限的新设备无法继续纳管。如需扩容，请凭该页面显示的机器码申请正式授权文件并导入。
2. 配置下发
下发了参数，但设备上没生效
- 确认任务状态
下发不是「点了就立刻完成」：任务要等设备下一次上报会话时才执行。
先看任务是否还停留在等待状态。
- 确认设备在线
离线设备无法执行下发，任务会一直排队。
- 回读校验
用「维护 → 诊断工具」读取该参数当前值，确认设备实际写回的结果。
- 查看日志
在日志中按设备筛选，确认下发是否被设备拒绝或报错。
重要：不要仅凭界面提示判定成功。
系统会在设备侧明确失败时给出失败结果，但「写回是否真的生效」最终以回读为准。
为什么下发不是立即生效的
TR-069 的下发必须发生在设备主动发起的会话内。平台把任务放进队列，
等设备下一次上报时执行。可以触发一次主动唤醒（ConnectionRequest）让设备尽快上报，
但唤醒只是加速手段，失败时会自动降级为等待下一次上报，不影响任务最终执行。
批量下发后部分设备没成功
- 先统计失败设备的共同特征：是否同一厂商型号、同一软件版本、同一分组。
- 用诊断工具抽查一台失败设备的关键参数，确认是设备不支持该参数还是取值不合法。
- 在工单「记录」中查看逐条失败原因，按原因归类后再决定是重试还是单独处理。
3. OLT 与 PON
OLT 查询或开通很慢
OLT 的操作需要真实建立设备连接并等待原厂 CLI 回显，写类操作单次耗时可能达到数十秒，
属预期行为。系统已针对写命令放宽等待时间，并在批量场景下把保存配置的动作合并到批次末尾，
以减少总耗时。
操作提醒：请勿在等待过程中反复点击提交，可能造成重复下发。
批量注册 ONT 是否安全
批量注册支持「仅预览」模式：只生成将要下发的命令而不真正执行。
建议在现网先跑一次预览、核对命令内容后再执行真实注册。
ONT 注册报错或状态不明确
- 确认该 ONT 的 SN 未被其他 PON 口占用。
- 确认所选 PON 口与槽位/端口信息正确。
- 部分厂商设备在特定回显下会返回业务错误码，系统会将其判为失败而非静默忽略；
请对照 OLT 厂商命令手册确认错误含义。
- 可用「CLI 调试台」直连 OLT 手动执行对应命令，观察原始回显。
4. 系统与运维
页面打开是空白或与文档不一致
- 先强制刷新（Ctrl+F5）清掉本地缓存的旧页面资源。
- 确认访问的地址与端口正确（管理端 8007、装维端 8008）。
- 若仍异常，检查服务是否正常运行、业务接口是否可访问。
装维助手 H5 打不开
- 确认手机与服务器网络互通，且 8008 端口已放行。
- 确认手机上使用的是正确的地址与端口。
升级包上传后无法安装
- 升级包必须来自官方且签名有效，被修改过内容的包会被直接拒绝。
- 确认包与当前版本的升级路径兼容。
- 查看页面的升级日志获取具体拒绝原因。
授权导入失败或额度显示不正确
- 授权与机器码绑定，换机、重装系统或更换虚拟化配置后机器码可能变化，需要重新申请授权。
- 确认授权文件未过期、未被截断（传输时使用二进制方式而不是复制文本）。
- 导入成功后刷新页面，核对可管理光猫数量、可管理 OLT 数量与单台 OLT 可注册 ONT 数量。
忘记管理员密码
请联系系统维护人员通过服务器侧方式重置，不建议直接改动数据库中的账号数据。
日常运维中请为每位使用者分配独立账号，避免共用管理员账号。
数据库会不会丢数据
系统使用带日志的数据库模式，正常断电与重启不会导致数据丢失。
但磁盘损坏、误删文件无法避免，因此定期备份数据库文件仍是必须的。
系统最多能管多少设备
实际规模取决于服务器配置与设备上报频率，主要由授权中的可管理光猫数量决定上限。
出厂免费版的可管理光猫数量为 10 台（另有 1 台 OLT、单台 OLT 可注册 10 个 ONT 的
独立免费额度）；可通过提升服务器规格与授权额度来扩容。
不同厂商的光猫都能管吗
只要设备遵循 TR-069 标准并正确配置 ACS 地址，即可纳管并读取标准参数。
厂商私有参数需要在「维护 → 光猫适配库」中做适配后才能正确识别，
未适配的设备可能表现为部分参数读取为空。