验证日期:2026-09-07
样本目录:E:\AI\security\firmware_samples
环境:Windows,Go CLI;使用项目引导脚本安装的 7-Zip 26.03 与 squashfs-tools-ng 1.3.2。
本表中的“完整”表示目标根文件系统已被实际展开并进入 JSON tree,不是只识别到格式或只打开外层 ZIP。计数包含 artifact、普通文件、目录以及 Windows 无法原样创建的 Linux 特殊节点元数据。
| 类别 | 输入层与关键内层 | 结果 | 实测目录树摘要 |
|---|---|---|---|
| OpenWrt Realtek | 厂商头 → uImage/gzip + SquashFS | 根文件系统完整;整体 partial |
874 文件、114 目录、200 特殊节点;V0.3 检查 117 ELF。SquashFS 位于 0x3B0080,已完整提取。0x40 处的 uImage-like 厂商头声明 gzip 数据从 0x80 开始,但按声明长度解码报 unexpected EOF,因此只有内核层为 partial;这可能是厂商修改的头/边界规则,不能仅据此断言原固件损坏。 |
| OWASP IoTGoat | gzip → MBR → EXT4 + SquashFS | 完整 | 1,252 文件、118 目录、214 特殊节点。 |
| TP-Link Archer C7 | ZIP → 厂商 BIN → 无尺寸字段 LZMA SquashFS | 完整 | 750 文件、51 目录、184 特殊节点。 |
| Google Pixel factory | ZIP → 内层 ZIP → boot/sparse → EXT4 | 完整 | 全链路 6,474 文件、1,352 目录、31 artifacts;最新 EXT4 专项回归另验证特殊节点物化。 |
| Google Pixel OTA | ZIP → update_engine payload → retrofit liblp → EXT4 | 完整 | 6,390 文件、1,163 目录、40 artifacts;操作数据、最终分区和 liblp metadata 均校验。 |
| Raspberry Pi OS | XZ → MBR → FAT + EXT4 | 完整 | 全盘链路 68,679 文件、6,232 目录;最新 EXT4 原生专项为 68,358 文件、6,149 目录,并验证冒号文件名和大小写冲突映射。 |
| OpenWrt QorIQ | FIT → gzip kernel → CPIO initramfs | 完整 | 1,014 文件、124 目录、6 artifacts。 |
| Netgear R7000 | ZIP → CHK/TRX 类厂商层 → SquashFS | 完整 | 1,790 文件、89 目录;10 组 Windows 大小写碰撞均保留并映射。 |
| ASUS RT-AC68U | ZIP → TRX/UBI → SquashFS | 完整 | 3,754 文件、183 目录;以重组后的 UBI 逻辑卷为准。 |
| TP-Link Archer AX55 | ZIP → UBI + FIT → XZ-BCJ SquashFS | 完整 | 3,734 文件、421 目录、388 特殊节点;使用有界块级 7-Zip XZ 回退。 |
| 样本 | SHA-256 |
|---|---|
| Realtek | 102F16A1346972262A5D72F6B141AA3CCFFE0768826FF4CDE32714E261515589 |
| IoTGoat | 6237949316E1B7B1FCDB73CABD7458D4E2EA9DB11034064B7B1C625867567BE3 |
| Archer C7 | B40060343D136452BF6912DA89D2DBB2874AB59D7D887CFEDF489B7B14533889 |
| Pixel factory | 27F59137F9802F6913F92D820BB0CBD80793F6E4A80C5F05E1242810903D4AEA |
| Pixel OTA | EFEA980D6359363B645435A5D077228D9A00D6F9772BF6ADF16E26090DBA0D53 |
| Raspberry Pi OS | EA4E84C501D6DD4F4B1D04EB84DF133A03F90A05EE2E8AB849185C17C2B0707B |
| QorIQ | E7C9096118ECC82AA8C93A3D9994A4E0221AA097884A3DFB9A5610C6061E688B |
| Netgear R7000 | B405D2C73809986ED32B412AF0BA28DAA195BCA9F80F582C8C3B35E5D2545772 |
| ASUS RT-AC68U | 262B4DA8F444B678669D6B49ADBA2858656F4275984D66978F4C3FE28A3F106F |
| Archer AX55 | 0BC07F70D041B0B9DF21DBC9FC846848C3F41DF68A3743C92129408B84A588FE |
Realtek 报告中的 partial 不表示根文件系统缺文件:
artifact-0003SquashFS:offset=3866752、length=2714696,状态extracted。- 根文件系统目录树:874 个文件、114 个目录,其中 200 个 Linux 特殊节点以元数据表达。
- V0.2 内容安全扫描和 V0.3 对 117 个 ELF 的 checksec 结果可用。
artifact-0002内核候选:offset=128、length=3832934,gzip 解码unexpected EOF,状态partial。
因此可以表述为“文件系统解包完成,内核层尚未完整解析”,不能表述为“整个固件所有层完整解包”。后续应针对 D-Link/Realtek 厂商头确认真实 payload 边界、校验算法和可能的尾部元数据,再决定是扩展 uImage 处理器还是把该层识别为独立厂商格式。
pwsh -NoProfile -File .\scripts\bootstrap-tools.ps1
go build -o .\bin\firmscope.exe .\cmd\firmscope
.\bin\firmscope.exe analyze `
-input 'E:\AI\security\firmware_samples\01_openwrt_realtek\openwrt-25.12.3-realtek-rtl838x-d-link_dgs-1210-10p-squashfs-factory_image1.bin' `
-extract-dir .\output\realtek `
-report .\output\realtek.json `
-through v0.3测试输出和固件样本不进入 Git。报告中的 artifacts 是判定每一层是否完整的依据;warnings 和 partial 必须保留,不能用顶层命令成功掩盖内层失败。