深入揭秘：逆向分析 Ubiquiti UniFi Inform 协议的通讯机制

引言：为什么需要了解 UniFi Inform 协议？

在 Ubiquiti 的网络生态系统中，UniFi 控制器（Controller）与各终端设备（如 AP、交换机、网关）之间的通讯是整个网络管理的核心。这种通讯通过一种被称为 Inform 协议 的机制实现。虽然 Ubiquiti 提供了完善的官方软件，但对于开发者、安全研究员或希望构建第三方控制器的技术爱好者来说，深入了解其背后的逆向工程过程极具价值。

UniFi Inform 协议基础概览

UniFi 设备默认通过 HTTP 协议与控制器进行通讯，通常指向控制器的 8080 端口。典型的 Inform URL 格式为：http://:8080/inform。尽管它是基于 HTTP 的，但其传输的 Payload（有效载荷）并非明文，而是经过了特定的封装、压缩和加密处理。

核心步骤：解析数据包结构

逆向分析发现，每个 Inform 数据包都包含一个自定义的 Packet Header（包头），随后是加密的二进制数据。包头通常包含以下关键信息：

• Magic Number：用于识别协议版本（常见如 TNW 标记）。
• Packet Version：协议的版本号。
• MAC Address：发送该心跳包的设备的硬件地址。
• Flags：指示数据是否经过 Encryption（加密）或 Compression（压缩）。
• Payload Length：随后数据的总长度。

数据处理流：解密与解压

要获取原始的 JSON 格式管理数据，必须经过以下两个关键的技术步骤：

• AES 解密：UniFi 使用 AES-128-CBC 加密算法。对于未采用（Adoption）的设备，使用的是默认的预共享密钥；对于已采用的设备，密钥则是在采用过程中生成的 Auth Key。
• Snappy 解压：在解密之后，数据通常使用 Google 的 Snappy 算法进行压缩。这种算法以极高的压缩/解压速度著称，非常适合嵌入式设备。

JSON 载荷分析

一旦成功解密并解压，你将看到一个包含设备状态的 JSON Object。其中包含了诸如 model、version、uptime、ip 以及当前连接的用户数等详细遥测数据。控制器则会返回一个包含指令的 JSON 响应，告诉设备如何配置 SSID、VLAN 或进行固件更新。

技术总结与启示

通过对 UniFi Inform 协议的逆向工程，我们不仅可以实现对网络设备的精细化监控，还能在特定的受限环境中开发轻量级的控制器替代方案。这一过程展示了现代物联网（IoT）设备如何在保证性能（Snappy 压缩）的同时兼顾安全性（AES 加密）。