系统管理
系统管理页面用于维护设备本身,不负责具体外设接线。除 GET /api/health 和 GET /api/system/capabilities 外,系统 API 均需登录。
页面索引
| 页面 | 用途 |
|---|---|
| 仪表盘 | 查看网络、MQTT、内存、运行时间和外设摘要 |
| 设备配置 | 设备名称、ID、时区、NTP 和日志级别 |
| 网络配置 | WiFi AP/STA、自定义本地域名、静态 IP、W5500、4G |
| 功能配置 | 查看编译状态、按需启用功能并重启生效 |
| 设备屏幕 | 触摸屏布局、数据/控制/受限数值绑定、可视化天气和可选最近十点图表 |
| 用户与认证 | 密码、会话和账户锁定 |
| 健康监控 | DRAM/PSRAM、任务栈、内存门控和恢复 |
| SSE 实时推送 | 传感器、Modbus 和 MQTT 状态事件 |
| 设备日志 | 查询、清理和导出运行日志 |
| 配置备份与文件接口 | 设备配置中的选择性导入导出,以及定制固件的可选文件 API |
维护闭环
常用 API
| 模块 | 入口 |
|---|---|
| 探活 | GET /api/health(免认证) |
| 系统 | /api/system/info、/status、/health、/metrics、/capabilities |
| 设备 | /api/device/config、/api/device/info、/api/device/time |
| 网络 | /api/wifi/*、/api/network/config、/api/network/status |
| 功能 | /api/features/status、/config、/estimate、/apply |
| 配置备份 | /api/config/transfer/* |
| 日志 | /api/logs* |
| 定制文件接口 | /api/files*、/api/filesystem(仅 FASTBEE_ENABLE_FILE_MANAGER=1) |
完整字段和状态码见 API 接口参考。
统一功能状态
所有功能均按以下顺序判断:
text
compiled(已编译)
AND userEnabled(用户开启)
AND budgetPassed(内存预算通过)
AND NOT runtimeDisabled(未被运行期保护临时停用)页面中的 locked 表示不能通过运行时配置补齐;active=false 可能是用户关闭、依赖未满足或内存预算拒绝。请先查看 /api/features/status,再决定是否修改构建或硬件。
安全和备份
- 首次登录后修改
admin默认密码。 - 会话在设备重启后失效;不要把
sessionId写入脚本或日志。 - 配置迁移优先使用 Web 的导入/导出;导入前保留当前备份。
- 恢复出厂会清除网络、设备、协议、外设和规则配置,并重启设备。
- 低内存时部分接口返回
503,按响应中的Retry-After延迟重试,不要连续刷新。

