一条命令即可审计你自己的智能家居设备:它们向何处回传数据、明文传输还是 TLS、开放端口、A-F 评级,以及本地 HTML/PDF 报告。CLI + MCP 服务器,无需云端。
如果你觉得这个项目有用,可以通过购买 SkinToScan 套餐来支持我,那是我的另一个项目。这是一次性购买,直接资助我的开源工作。
iotaudit 适合任何想要对自己智能家居设备(摄像头、插座、喂食器、灯泡、门铃等)获得明确答案的人。它会监视设备在你的网络上的行为,并为每台设备给出 A-F 评级、一行安全结论以及一页 HTML 报告。一切都在本地运行:无需账户、无遥测、无云端。
我是为那些最终接入家庭 Wi-Fi 的廉价小设备而写它的。问题通常都一样:它在和谁通信、这些流量是否加密、有没有意外开放的端口,以及自上次以来有没有发生任何变化。
pipx install iotaudit
捕获流量需要 root 权限(sudo)。可选的端口扫描需要 nmap。PDF 导出和 MCP 服务器属于额外功能:pip install "iotaudit[pdf]" 和 pip install "iotaudit[mcp]"。更多安装说明(包括如何将 iotaudit 添加到 macOS sudo 的 PATH 中)请参阅使用指南。
国家/地区查询使用内置的 DB-IP Lite 数据库;iotaudit geoip update 会安装更新的月度文件。
一条命令会要求你确认这是你的网络,发现设备,运行安全检查,被动捕获流量,并生成报告:
sudo iotaudit auto
文件会以 HTML 和 JSON 格式保存到 ~/iotaudit/YYYY-MM-DD/ 中(如果安装了该额外组件,还会保存一份 PDF)。如果你已经从 Wireshark、路由器、OpenWrt tcpdump 或 PCAPdroid 获取了捕获文件,可以在无需 root 权限的情况下对其进行分析:
iotaudit analyze capture.pcap
从 OpenWrt 路由器进行分步抓包的指南(通过 SSH 运行 tcpdump,然后执行 iotaudit analyze)见 OpenWrt 指南。
如果你已经确认这是自己的网络,可以用 --i-own-this-network 跳过手动输入确认。若要通过本机拉取某台设备的流量,请使用 ARP 或热点模式。参见抓包模式。
iotaudit profile export 将已保存的审计转换为可分享的配置文件草稿(参见设备配置文件)。iotaudit diff(以及 --compare)查看自上次审计以来的变化。--summary-json 会在 stdout 上输出简洁的评级摘要,而当最差评级低于 B 时,--fail-under B 会以退出码 1 退出。--redact。--ha-mqtt,支持自动发现,因此无需 YAML 即可显示传感器),或写入 JSON 文件(--ha-json)。参见 Home Assistant 指南。当前版本为 0.1.25。示例报告和简短演示位于报告页面。完整的漏洞源仍在路线图中。
pip install "iotaudit[mcp]"
iotaudit-mcp
这会启动一个本地 MCP 服务器(stdio),使你机器上的客户端能够运行相同的审计工具。diff_results 以与 iotaudit diff 相同的方式比较两份已保存的 JSON 审计结果。该服务器已列于 mcpservers.org 和官方 MCP Registry。工具列表与选项:MCP server。
iotaudit 仅审计你自己的网络和你自己的设备。它会拒绝非私有目标,并要求 --i-own-this-network 或交互式 I OWN THIS NETWORK 确认。在你并不拥有的网络上进行 ARP 或 NDP 欺骗可能是违法的。所有数据均保留在本地。没有遥测。
发现结果基于观测到的流量得出的指标,并非任何厂商不当行为的证据。IP 地理位置由 DB-IP 提供。MIT 许可。
auto、PDF、diff、cron、导出、credcheck、UPnP 以及 Web UI