关于 ffind
ffind 技能用于查找和分析文件及目录中的文件类型,面向固件与 IoT 安全分析。它可识别安全相关文件类型,并提取 ext2/3/4 或 F2FS 文件系统,支持文本、JSON 和精简输出。
主要功能
- 01识别文件及目录中的文件类型
- 02提取 ext2/3/4 与 F2FS 文件系统
- 03显示安全相关文件类型
- 04支持文本、JSON 和精简输出
适用场景
- 01检查固件镜像中的文件类型
- 02提取文件系统以便深入分析
- 03在多个文件中查找安全分析产物
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ brownfinesecurity/ iothackbot --skill ffind安装后在 Claude Code 中输入/ffind确认已加载。
详细介绍
Ffind - 高级文件查找器(支持提取)
使用 ffind 工具帮助用户查找和分析文件,支持高级类型检测和可选的文件系统提取功能。
工具概述
Ffind 可分析文件和目录、识别文件类型,并提取文件系统(ext2/3/4、F2FS)以进行深入分析。它专为固件和 IoT 设备分析而设计。
说明
当用户要求分析文件、查找特定文件类型或提取文件系统时:
-
了解目标:
- 询问他们想分析哪些路径
- 确定他们是想提取文件系统,还是仅进行分析
- 询问他们想查看所有文件类型,还是仅查看制品类型
-
执行分析:
- 使用 iothackbot bin 目录中的 ffind 命令
- 基本用法:
ffind <path> [<path2> ...] - 提取文件系统:
ffind <path> -e - 指定自定义提取目录:
ffind <path> -e -d /path/to/output - 显示所有文件类型:
ffind <path> -a - 显示详细输出:
ffind <path> -v
-
输出格式:
--format text(默认):带有类型摘要的彩色易读输出--format json:机器可读的 JSON--format quiet:最简输出
-
提取功能:
- 支持 ext2/ext3/ext4 文件系统(需要 e2fsprogs)
- 支持 F2FS 文件系统(需要 f2fs-tools)
- 提取需要 sudo 权限
- 默认提取位置:
/tmp/ffind_<timestamp>
示例
分析固件文件以查看文件类型:
ffind /path/to/firmware.bin
从固件映像中提取所有文件系统:
sudo ffind /path/to/firmware.bin -e
分析多个文件并显示所有类型:
ffind /path/to/file1.bin /path/to/file2.bin -a
提取到自定义目录:
sudo ffind /path/to/firmware.bin -e -d /tmp/my-extraction
重要说明
- 名称冲突:Sleuth Kit 也提供了一个
ffind(用于根据给定的 inode 查找文件名,参数为磁盘映像和 inode 编号)。如果which ffind指向/usr/bin/ffind或/usr/local/bin/ffind,下面的 iothackbot 参数(-e、-d <dir>、-a、--format)将被错误的二进制程序误读。请使用ffind --help确认(iothackbot 工具会显示--extract/--format);如果显示的是image inode用法,请改为通过仓库bin/目录中的完整路径调用 iothackbot 工具。 - 提取需要 root/sudo 权限
- 需要外部工具:e2fsprogs、f2fs-tools、util-linux
- 默认识别与安全分析相关的“制品”文件类型
- 使用
-a标志可查看所有文件类型,包括常见格式
评论
支持 Markdown