常见问题

看不到某个菜单

通常是权限不足。请检查：

  • 当前账号是否属于正确用户组。
  • 用户组是否具备对应功能权限。
  • 当前账号的数据范围是否包含目标组织。
  • 是否需要管理员权限。

设备连接失败

优先检查：

  1. IP 地址和端口是否可达。
  2. SSH、Telnet 或 SNMP 参数是否正确。
  3. 用户名、密码和提权密码是否正确。
  4. 防火墙或 ACL 是否放行。
  5. 设备是否限制登录来源。

巡检失败

常见原因：

  • 设备账号密码错误。
  • 提权命令或提权密码错误。
  • 巡检命令不适配厂商设备。
  • 设备响应超时。
  • 并发过高导致设备压力或网络拥塞。

监控没有数据

检查顺序：

  1. 监控项是否启用。
  2. 设备是否纳入监控范围。
  3. SNMP 参数是否正确。
  4. OID 是否适配设备。
  5. 采集任务是否运行。
  6. 日志中心是否有采集错误。

终端定位不到端口

可能原因：

  • 网关设备没有采集到 ARP。
  • 接入设备没有采集到 MAC/FDB。
  • 设备角色设置不正确。
  • 接口发现未完成。
  • 终端经过无线、NAT 或其他中间链路。
  • ARP 和 MAC 数据采集时间不一致。

机柜 U 位保存失败

检查：

  • U 位是否超过机柜总高度。
  • 同一机柜同一侧是否已有设备占用。
  • 机柜、机房、站点编码是否重复。

启动后数据不一致

通常是工作目录不同，导致读取了不同的 data/device_inspector.db。生产环境建议设置 WORKSPACE_PATH。

GitHub Pages 文档更新后没变化

检查：

  1. 是否执行了 hexo clean && hexo generate && hexo deploy。
  2. source/CNAME 是否仍然存在。
  3. GitHub Pages 是否部署完成。
  4. 浏览器或 Cloudflare 是否有缓存。