Skip to content

Latest commit

 

History

History
62 lines (48 loc) · 4.64 KB

SAMPLE_VALIDATION.md

File metadata and controls

62 lines (48 loc) · 4.64 KB

固件样本验证基线

验证日期: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

样本 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 的使用边界

Realtek 报告中的 partial 不表示根文件系统缺文件:

  • artifact-0003 SquashFS: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 必须保留,不能用顶层命令成功掩盖内层失败。