Introduce

多指纹库聚合识别引擎. 当前支持fingers(主指纹库) wappalyzer, fingerprinthub, ehole, goby 指纹

不用再挑选指纹识别的工具, AllInOne一站式实现

使用了fingers的工具:

• ⭐ spray 最佳实践, 集合了目录爆破, 指纹识别, 信息收集等等功能的超强性能的http fuzz工具
• gogo, 使用了fingers原生指纹库, 红队向的自动化扫描引擎
• zombie, 在爆破前使用fingers进行指纹验证, 提高爆破效率

(任何使用了fingers的工具欢迎在issue中告诉我, 我会将你的工具添加到这里)

Features

• 支持多指纹库聚合识别
  • ✅ fingers 原生指纹库
  • ✅ wappalyzer
  • ✅ fingerprinthub
  • ✅ ehole
  • ✅ goby
• 支持多指纹源favicon识别
• 超强性能, 单个站点识别 <100ms. 重写了各指纹库的引擎, 并极大优化了性能
• 聚合输出, 多指纹库的结果将会自动整合
• 支持CPE的URI, FSB, WFN格式输出

morefingers

https://github.com/chainreactors/morefingers

fingers的拓展引擎, 有更全更大的指纹库.

从对闭源工具的逆向得到的指纹库, 为了避免可能存在的纠纷, 不提供开源版本.

QuickStart

go get github.com/chainreactors/fingers@master

支持 Go 1.17 及以上。规则正则默认使用标准库；在 Go 1.24 及以上可以换成更快的 RE2，只需额外引入一行：

import _ "github.com/chainreactors/fingers/re2" // go get github.com/chainreactors/fingers/re2

Example

document: https://chainreactors.github.io/wiki/libs/fingers/

调用内置所有进行指纹引擎识别, 示例:

func TestEngine(t *testing.T) {
    engine, err := NewEngine()
    if err != nil {
       panic(err)
    }
    resp, err := http.Get("http://127.0.0.1:8080/")
    if err != nil {
       return
    }
    content := httputils.ReadRaw(resp)
    frames, err := engine.DetectContent(content)
    if err != nil {
        return
    }
    fmt.Println(frames.String())
}

调用SDK识别Favicon指纹, 示例:

func TestFavicon(t *testing.T) {
    engine, err := NewEngine()
    if err != nil {
        panic(err)
    }
    resp, err := http.Get("http://baidu.com/favicon.ico")
    if err != nil {
        return
    }
    content := httputils.ReadRaw(resp)
    body, _, _ := httputils.SplitHttpRaw(content)
    frame := engine.DetectFavicon(body)
    fmt.Println(frame.String())
}

更多用法请见: https://chainreactors.github.io/wiki/libs/fingers/sdk/

用 Jev 提升识别效果

规则引擎召回能力强，但会有误报、多个引擎的同名重复，版本号也难以拿准。配置一个 TypeSafe Jev key，引擎就会审查每一次 Web 匹配的规则结果，只返回证据支持的结果：去掉误报和重复，补全版本。调用方式不变。

engine, _ := fingers.NewEngine()
engine.EnableJudge("")                 // 空字符串读取 TYPESAFE_API_KEY
frames, _ := engine.DetectContent(raw) // WebMatch、Match、DetectResponse 同样生效

命令行：engine -u https://example.com --jev-key <KEY>。

• 只审查，不识别：Jev 只判断规则给出的结论是否成立，从不说出产品名，因此不会凭空多出结果。
• 失败时退回规则结果：请求失败或 key 无效时，返回的就是纯规则结果。
• 每条结果都带依据：保留下来的结果带有 Framework.Judge（选项、Outcome、置信度、证据），随现有输出一起序列化。
• 代价：每个有命中的页面约 1～2 个请求，相同页面命中缓存。

漏报不在扫描时处理，因为 Jev 不说出产品名。维护者用 judge/maintain 离线发现规则漏掉的产品，交给人命名后用 judge/gen 生成规则，更新到指纹库后所有用户受益。

需要自定义 Provider、阈值或查看被剔除条目及原因时，直接使用 judge 包，或给 engine.Judge 赋值，见 judge/README.md。判定机制只有一个 Claim：代码提出断言并附上证据，Provider 选出证据支持的选项，选项的 Outcome（holds / refuted / insufficient）驱动固定动作。Claim 合约、缓存和 Jev 客户端在 github.com/chainreactors/utils/jev。

数据外发：判定时会把响应的精简视图发给 Provider，包括响应头（去掉 Date、Set-Cookie 值等无关头）、Cookie 名、标题、generator/description、脚本和样式路径、内联脚本开头、HTML 注释、表单字段名，以及正文前 1500 字。扫描授权范围内的目标前，请确认允许把这些内容发送给第三方服务。

当前实现于 2026-09-27 在 69 份已标注的真实响应上复测（jev-1.13.0）：误报 24 → 0，真实命中误删 0，版本正确 36、错误 0；不加载新增规则时 Discover 找出全部 3 个漏报产品，加载后无误报警。见 复测报告。

设计讨论见 #34。

fingers 引擎

fingers指纹引擎是目前特性最丰富, 性能最强的指纹规则库.

• 支持多种方式规则配置
• 支持多种方式的版本号匹配
• 404/favicon/waf/cdn/供应链指纹识别
• 主动指纹识别
• 超强性能, 采用了缓存,正则预编译,默认端口,优先级等等算法提高引擎性能
• 重点指纹,指纹来源与tag标记

内置指纹库

指纹库位于: https://github.com/chainreactors/templates/tree/master/fingers

文档: https://chainreactors.github.io/wiki/libs/fingers/rule/

tcp指纹与http指纹为同一格式, 但通过不同的文件进行管理

完整的配置

fingers设计的核心思路是命中一个指纹仅需要一条规则, 因此配置的多条规则中, 只需要任意一条命中即标记为命中, 需要在编写指纹的时候注意找到最能匹配目标框架的那条规则.

一个完整的配置:

- name: frame   # 指纹名字, 匹配到的时候输出的值
  default_port: # 指纹的默认端口, 加速匹配. tcp指纹如果匹配到第一个就会结束指纹匹配, http则会继续匹配, 所以默认端口对http没有特殊优化
    - '1111'
  protocol: http  # tcp/http, 默认为http
  rule:
   - version: v1.1.1 # 可不填, 默认为空, 表示无具体版本
     regexps: # 匹配的方式
        vuln: # 匹配到vuln的正则, 如果匹配到, 会输出framework为name的同时, 还会添加vuln为vuln的漏洞信息
          - version:(.*) # vuln只支持正则,  同时支持版本号匹配, 使用括号的正则分组. 只支持第一组
        regexp: # 匹配指纹正则
          - "finger.*test" 
       # 除了正则, 还支持其他类型的匹配, 包括以下方式
        header: # 仅http协议可用, 匹配header中包含的数据
          - string
        body: # 包含匹配, 非正则表达式
          - string
        md5: # 匹配body的md5hash
          - [md5]
        mmh3: # 匹配body的mmh3hash
          - [mmh3]
          
        # 只有上面规则中的至少一条命中才会执行version
        version: 
          - version:(.*)  # 某些情况下难以同时编写指纹的正则与关于版本的正则, 可以特地为version写一条正则

     favicon: # favicon的hash值, 仅http生效
        md5:
          - f7e3d97f404e71d302b3239eef48d5f2
        mmh3:
          - '516963061'
     level: 1      # 0代表不需要主动发包, 1代表需要额外主动发起请求. 如果当前level为0则不会发送数据, 但是依旧会进行被动的指纹匹配.
     send_data: "info\n" # 匹配指纹需要主动发送的数据
     vuln: frame_unauthorized # 如果regexps中的vuln命中, 则会输出漏洞名称. 某些漏洞也可以通过匹配关键字识别, 因此一些简单的poc使用指纹的方式实现, 复杂的poc请使用-e下的nuclei yaml配置

为了压缩体积, 没有特别指定的参数可以留空会使用默认值。

在两个配置文件中包含大量案例可供参考。

但实际上大部分字段都不需要配置, 仅作为特殊情况下的能力储备。

每个指纹都可以有多个rule, 每个rule中都有一个regexps, 每个regexps有多条不同种类的字符串/正则/hash

TODO

• 指纹名重定向, 统一多指纹库的同一指纹不同名问题
• 指纹黑名单, 用于过滤指纹库中的垃圾指纹
• 更丰富的CPE相关特性支持
• 更优雅的与nuclei或其他漏洞库联动
• 支持更多引擎
  • nuclei technologies 实现
  • fingerprinthub v4
  • tidefinger
  • kscan
  • nmap

Thanks

• wappalyzer
• fingerprinthub
• ehole
• goby @XiaoliChan @9bie