常见问题
需要开端口或者做内网穿透吗？
不需要。设备上行走 WSS 443，和目标板的 SSH、网页一样是普通出站流量，企业防火墙一般不会因为这块板子放行新规则。
1883 端口怎么连不上？
本来就连不上，也不该连。1883 只在容器网络内给后端用，对公网不开放 —— 设备全走 443。这是刻意的攻击面收敛，不是配置错误。
断网期间的日志会丢吗？
设计上不丢：WiFi 断连后继续抓取，先入 RAM 再落 littlefs，恢复后按批次序号补传。是否真的无损可以验证 —— 服务端会记录 seq 缺口区间，页面上看得到。反过来，如果 littlefs 写满或掉电前没来得及落盘，那部分确实没了，缺口记录会如实显示。
为什么同一批日志可能出现两次？
界面上不会，因为服务端按 (device_id, seq) 去重。QoS 1 的重发、离线回放与实时流的重叠都只入库一次，这是有意为之的幂等设计。
实时看日志会占存储空间吗？
不会。实时观看不落库，只消耗带宽。想留历史就打开录制开关，那时候才开始占存储、也才开始计当日流量额度。
为什么清理了旧日志还是收不到新日志？
大概率撞的是「今日流量」而不是「存储」。清理只能腾存储空间，当天额度不会因此恢复，要等自然日重置。页面上两条额度条是分开显示的，先看是哪一条满。
波特率最高能到多少？
抓取侧支持到 3,000,000 bps。但要注意：波特率越高，实时观看的月带宽消耗越大 —— 1.5 Mbps 连续看两小时，一台设备一个月就是约 55 GB。普通调试（115200）不用担心这个。
设备 ID 会变吗？
不会。它由 MAC 后 6 位生成，出厂写进 NVS，终身不变。换 WiFi、重新配网、甚至固件升级都不会改变它。device_secret 同理。
AI 会不会在设备上乱执行命令？
不会自动执行。流程是：AI 生成计划 → 你看确认卡（列出全部命令与敏感命令数）→ 你点头才开始执行。查询类命令自动跑，写操作（如重载驱动）每次都弹确认卡、60 秒无响应视为拒绝；出厂复位和刷写类命令在协议层直接拒绝。
AI 的结论能信吗？
每份结果强制带三段脚注：已验证（基于什么证据）、假设（依赖什么前提）、未能完成（什么没覆盖）。结论必须引用证据中的命令响应或日志行号，无法确认的写进 unknowns，禁止编造。
控制台地址是什么？
https://iot.snapwhere.app，入口是根路径，不是 /console。登录接口是 POST /api/auth/login。
可以私有化部署吗？
可以，整套是容器化的（Caddy + MQTT broker + Postgres + 后端）。有这个需求请走 联系我们 说明设备规模与网络环境。