NickCirv/binary-inspector
GitHub: NickCirv/binary-inspector
一个零依赖的 Node.js CLI 工具，提供 hex dump、文件类型检测、熵分析和字符串提取等二进制文件分析能力。
Stars: 0 | Forks: 0
# binary-inspector
**Hex dump、magic byte 检测、entropy 分析、strings 提取与 pattern 搜索 — 尽在一个零依赖的 CLI 工具中。**
[](LICENSE)
[](package.json)
[](package.json)
## 安装
```
npx github:NickCirv/binary-inspector
[options]
```
或者全局安装：
```
npm install -g github:NickCirv/binary-inspector
```
## 用法
```
# Hex dump (默认)
binx image.png
# 通过 magic bytes 检测文件类型
binx /bin/ls --type
# Entropy + 文件信息
binx firmware.bin --info
# 提取可打印字符串 (最小长度 8)
binx /bin/ls --strings --min-len 8
# 搜索 hex pattern
binx archive.zip --search "50 4B 03 04"
# 完整分析为 JSON
binx image.png --all --json
```
| 标志 | 描述 |
|---|---|
| `--hex` | Hex dump（未指定其他模式时的默认选项） |
| `--type` | 通过 magic bytes 检测文件类型（支持 30+ 种签名） |
| `--info` | 显示文件大小、权限以及 Shannon entropy |
| `--strings` | 查找可打印的 ASCII 序列 |
| `--freq` | Byte 频率分析，显示前 10 名 |
| `--search ` | 搜索特定的 hex pattern，例如 `"FF D8 FF"` |
| `--offset ` | 从 byte offset N 处开始 |
| `--length ` | 从 offset 处读取 N 个 byte |
| `--min-len ` | `--strings` 的最小字符串长度（默认：4） |
| `--all` | 运行所有分析 |
| `--json` | 以 JSON 格式输出完整分析结果 |
| `--no-color` | 禁用彩色输出 |
## 功能说明
`binary-inspector` 可以读取任何文件，让你无需安装除 Node 之外的任何软件即可探索其原始 byte。它通过 magic bytes 识别 30 多种格式（如 PNG、JPEG、ELF、Mach-O、ZIP、SQLite、WASM 等），计算 Shannon entropy 以标记加密或压缩的区域，提取可打印的 strings，并搜索任意的 hex pattern —— 所有这些都可以通过具有良好可读性的彩色终端输出或纯净的 JSON 格式来呈现。
零依赖 · Node ≥ 18 · MIT · 作者：NickCirv标签：GNU通用公共许可证, MITM代理, Node.js, SOC Prime, 二进制分析, 云安全运维, 云资产清单, 动态分析, 开发工具, 数据可视化, 文件解析, 文档结构分析, 自定义脚本, 逆向工程