GXX 是一款高性能指纹识别工具，基于 YAML 配置的 CEL 表达式规则进行目标系统识别。支持 HTTP/HTTPS、TCP、UDP 协议，可进行大规模批量目标扫描。
- YAML 规则引擎 - 基于 CEL 表达式的指纹匹配，规则简洁强大
- 高性能并发 - ants 协程池 + 两级并发（URL 级 + 规则级），支持大规模目标
- 多协议支持 - HTTP/HTTPS、TCP、UDP、Raw HTTP
- 技术栈识别 - 内置 Wappalyzer 引擎识别网站技术组件
- 多格式输出 - TXT / CSV / JSON，支持 Unix Domain Socket 实时推送
- SDK 接口 - 独立 SDK 包，所有对外类型自包含，支持
context.Context - 内存优化 - CEL 环境单例 + Program 缓存 + 延迟格式化日志 + 对象池
# 扫描单个目标 gxx -u https://example.com # 从文件批量扫描 gxx -f targets.txt # 使用代理 gxx -u https://example.com --proxy http://127.0.0.1:8080 # 输出为 CSV（格式由扩展名自动识别） gxx -u https://example.com -o results.csv # JSON 输出 gxx -u https://example.com -o results.json --json # 调试模式 gxx -u https://example.com --debug # 设置规则并发线程数 gxx -u https://example.com -rt 500
package main import ( "context" "fmt" "gxx/sdk" "log" ) func main() { ctx := context.Background() // 1. 初始化指纹规则 options, _ := sdk.NewFingerOptions() if err := sdk.InitFingerRules(options); err != nil { log.Fatal(err) } // 2. 执行指纹识别 result, err := sdk.FingerScan(ctx, "https://example.com", "", 10) if err != nil { log.Fatal(err) } // 3. 读取结果 fmt.Printf("URL: %s 状态码: %d 标题: %s\n", result.URL, result.StatusCode, result.Title) for _, m := range result.Matches { fmt.Printf(" - %s (%s)\n", m.Info.Name, m.Info.ID) } }详细 SDK 文档参见 sdk/sdk.md。
| 参数 | 说明 |
-u, --url | 目标 URL/主机（可指定多个） |
-f, --file | 目标列表文件（每行一个） |
-t, --threads | URL 并发线程数（默认 5） |
-rt, --rulethreads | 规则并发线程数（默认 200，最大 5000） |
| 参数 | 说明 |
-o, --output | 输出文件路径（txt/csv/json） |
--json | JSON 格式输出 |
--sock | Unix Domain Socket 实时输出路径 |
| 参数 | 说明 |
--proxy | HTTP/SOCKS5 代理 |
-p | 测试单个 YAML 文件 |
-pf | 测试指定目录的 YAML 文件 |
--debug | 开启调试模式 |
--no-file-log | 禁用文件日志 |
--timeout | 请求超时（秒，默认 3） |
gxx/ ├── cmd/ # CLI 入口 │ ├── main.go # 主程序 │ └── cli/ # 命令行处理 ├── sdk/ # SDK 对外接口（所有对外类型均在此定义） │ ├── sdk.go # 业务 API │ ├── sdk.md # SDK 文档 │ └── debug/ # 运维/调试 API（内存监控、GC等） ├── pkg/ # 核心引擎 │ ├── cel/ # CEL 表达式引擎（全局环境单例 + Program 缓存） │ ├── finger/ # 指纹规则解析与执行 │ ├── runner/ # 扫描调度器（工作池、缓存、监控） │ ├── network/ # 网络请求层（HTTP/TCP/UDP） │ └── wappalyzer/ # Wappalyzer 技术栈识别 ├── types/ # 公共类型定义 ├── utils/ # 基础设施 │ ├── logger/ # 日志系统（延迟格式化，高并发友好） │ ├── output/ # 多格式输出 │ ├── common/ # 通用工具 │ ├── config/ # 配置管理 │ └── proto/ # Protobuf 协议定义 ├── fingerYaml/ # 内置指纹规则库（embed） └── example/ # 示例代码 ├── basic_scan/ # 基本扫描 ├── api_scan_baidu/ # API 调用示例 ├── file_target_scan/ # 文件批量扫描 ├── proxy_scan/ # 代理扫描 └── wappalyzer_scan/ # 技术栈识别
目标输入 → 存活探测(GET /) → 基础信息提取 → 缓存预热 → 规则并发匹配 → 结果输出 │ │ 标题/证书/ICP/Wappalyzer CEL表达式评估 (2348条规则×200并发)
- 存活探测：对目标发起 GET / 请求，获取标题、证书、服务器信息、ICP 备案号、Wappalyzer 技术栈
- 缓存预热：将基础响应写入缓存，后续规则匹配时直接复用（TTL + LRU 驱逐）
- 规则匹配：2348 条指纹规则通过全局规则池（200 并发）并行执行 CEL 表达式评估
- 结果输出：匹配结果实时输出到控制台 + 文件 + Socket
| 优化项 | 效果 |
CEL 基础环境单例 + Extend() 派生 | 消除每条规则创建 cel.NewEnv() 的重量级开销 |
CEL Program 缓存 (sync.Map) | 相同表达式零重复编译 |
延迟格式化日志 (logger.Debug(format, args...)) | 非 Debug 模式下零字符串分配 |
SetVariableMap 跳过 proto 对象 | 消除 64% 的 protobuf 序列化分配 (9.3GB → 0) |
| HTTP 客户端池化 | 相同配置复用客户端实例 |
| Wappalyzer 全局单例 | 启动时加载一次，全程共享 |
| 指纹快照版本号缓存 | 扫描期间只复制一次指纹列表 |
| 内存监控频率调优 | ReadMemStats 从 5s 降到 15s，减少 STW |
| 指标 | 值 |
| 总分配 | 11.8 GB |
| 峰值堆 | 539 MB |
| 最终残留 | 147 MB |
| GC CPU | 3% |
| 扫描耗时 | 20s |
| 零 goroutine 泄漏 | race detector 验证通过 |
id: web-application info: name: Web应用识别 author: 作者名 description: 识别特定Web应用 rules: r0: request: method: GET path: / expression: response.status == 200 && response.body.ibcontains(b"特征字符串") expression: r0()
详细规则语法参考 docs/指纹规则格式说明.md。
# Makefile 构建 make build # 基本构建 make build-embed # 嵌入指纹库 make release # 构建发布包 # 手动编译 CGO_ENABLED=0 go build -ldflags "-w -s" -o gxx cmd/main.go # 构建脚本 chmod +x build.sh && ./build.sh
本工具仅用于授权的安全测试和研究目的。使用者应遵守相关法律法规，未经授权不得对目标系统进行扫描。工具作者不对任何滥用行为负责。
MIT License