文档
面向开发者和系统管理员的技术说明、规范和笔记。
面向用户
- 用户指南 ——应用安装、把程序写入控制器、配对、访客密钥、自动化与安全。
- 控制器配置器 ——选择手机与控制器之间的通信方式。
- 无需更换程序的集成方式 ——Tasmota、ESPHome、Home Assistant 和 Shelly 通过 Entrixy 的 Webhook 接入。
架构与协议
- 架构 v2 ——客户端—服务器—控制器的整体框图、数据流和消息格式。
- 端到端加密架构 ——端到端加密：什么在哪里被加密（设备上的 AES-256-GCM）。
- BLE — 威胁模型 ——监听无线信号的攻击者能做什么、不能做什么（ECDH X25519 配 HMAC-SHA256）。
- BLE — 时间同步 ——控制器如何获知当前时间，以便校验访客密钥的有效期窗口。
固件与脚本源码
- /esp32-example/ ——BLE 程序（NimBLE、深度休眠）。配置器所用的模板
/esp/ble/. - /esp32-ws-example/ ——ESP32 的 Wi-Fi 程序（WSS 客户端与继电器）。配置器所用的模板
/esp/socket/（ESP32 模式）。 - /integrations/esp8266/ ——ESP8266 的 Wi-Fi 程序。配置器所用的模板
/esp/socket/（ESP8266 模式）。 - /integrations/raspberry-pi/ ——树莓派上的 Python Wi-Fi 脚本。配置器所用的模板
/esp/socket/（Pi 模式）。 - /integrations/nodejs/ ——用于无头服务器和 OpenWRT 路由器的 Node.js Wi-Fi 客户端。配置器暂时还不能构建它，但协议是兼容的。
设计与界面
- 设计规范 ——配色、字体排版和应用中的组件。
服务器运维
- 容量 ——面向 10 万用户的负载估算，以及瓶颈所在。
- 10 万级扩容方案 ——A/B/C/D 四个阶段：做什么，按什么顺序做。
- 服务器负载——从哪来 ——服务器把资源花在了哪里，以及可以怎么办。
- 服务器负载看板 ——24 小时内 WebSocket 连接数、CPU 和内存的曲线。
测试
- 测试计划 ——191 个场景，其中 37 个对生产服务器至关重要。涵盖 BLE 配对、WebSocket 在线状态、访客密钥、地理／Wi-Fi／时间条件、Webhook（手机端与服务器端）、重启恢复以及本地化。