xmap

command module

v0.1.0 Latest Latest Go to latest Published: Nov 25, 2025 License: MIT Imports: 5 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/tongchengbin/xmap

Links

Open Source Insights

README ¶

XMap

高性能分布式网络服务指纹识别框架

中文文档 | English Documentation

简介

XMap 是一个基于 Go 语言的高性能分布式网络服务指纹识别框架，它在 gonmap 的基础上进行了架构优化和功能扩展，专注于提供更高效、可扩展的网络服务识别能力。XMap 特别适合在大规模分布式环境中使用，支持多任务共享指纹库同时使用独立扫描参数的场景。

🌟 主要特性

高性能扫描引擎：基于 gonmap 优化的 TCP/UDP 服务探测和识别
共享指纹库：多任务共享指纹加载，减少内存占用和初始化时间
独立扫描参数：每个扫描任务可使用自定义的扫描参数
分布式架构：支持水平扩展的工作节点
灵活的插件系统：支持自定义探测和匹配逻辑
完善的上下文控制：支持超时和取消机制
丰富的输出格式：支持 JSON、CSV 等多种输出格式
实时监控：提供扫描进度和资源使用情况的实时监控
Web指纹识别：集成appfinger实现高效的Web应用指纹识别
美观的输出：提供类似Nuclei的彩色输出格式，提升用户体验

🚀 快速开始

安装

使用 go install 安装

# 直接安装最新版本
go install github.com/tongchengbin/xmap@latest

从源码安装

# 克隆仓库
git clone https://github.com/tongchengbin/xmap.git
cd xmap

# 安装依赖
go mod download

# 编译
go build -o xmap main.go

# 运行
./xmap -h

使用Docker

# 构建Docker镜像
docker build -t xmap .

# 运行
docker run --rm xmap -h

基本用法

# 扫描单个目标
xmap -t 192.168.1.1

# 扫描多个目标
xmap -t 192.168.1.1,192.168.1.2

# 扫描多个端口
xmap -t 192.168.1.1 -p 80,443,8080-8090

# 从文件读取目标
xmap -l targets.txt

# 使用快速模式
xmap -t 192.168.1.1 -f

# 指定输出格式（console, json, csv）
xmap -t 192.168.1.1 -ot json

# 将结果输出到文件
xmap -t 192.168.1.1 -o results.json -ot json

# 显示详细日志
xmap -t 192.168.1.1 -v

# 更新指纹规则库
xmap -ur

编程接口示例

package main

import (
	"context"
	"fmt"
	"time"

	"github.com/tongchengbin/xmap/pkg/api"
	"github.com/tongchengbin/xmap/pkg/types"
)

func main() {
	// 创建XMap实例
	xmap := api.NewXMap(
		api.WithTimeout(5*time.Second),
		api.WithRetries(2),
		api.WithVersionIntensity(7),
	)

	// 创建扫描目标
	target := &types.ScanTarget{
		IP:       "192.168.1.1",
		Port:     80,
		Protocol: "tcp",
	}

	// 执行扫描
	ctx := context.Background()
	
	// 使用回调函数处理结果
	scanOptions := &types.ScanOptions{
		Timeout:          5,
		VersionIntensity: 7,
	}
	
	err := xmap.ExecuteWithResultCallback(ctx, []*types.ScanTarget{target}, scanOptions,
		func(result *types.ScanResult) {
			// 处理结果
			fmt.Printf("IP: %s, 端口: %d, 服务: %s\n",
				result.Target.IP, result.Target.Port, result.Service)
			
			// 显示组件信息
			for _, component := range result.Components {
				name, _ := component["name"]
				version, _ := component["version"]
				fmt.Printf("\t组件: %v, 版本: %v\n", name, version)
			}
		},
	)
	
	if err != nil {
		fmt.Printf("扫描失败: %v\n", err)
		return
	}
}

🏗️ 架构设计

XMap 采用模块化设计，主要包含以下核心组件：

┌─────────────────────────────────────────────────────────────┐
│                      XMap Framework                          │
├─────────────┬─────────────┬───────────────┬─────────────────┤
│             │             │               │                 │
│  Fingerprint│   Scanner   │    Matcher    │     Worker      │
│   Manager   │   Engine    │     Engine    │      Pool       │
│             │             │               │                 │
├─────────────┼─────────────┼───────────────┼─────────────────┤
│             │             │               │                 │
│  Probe      │  Protocol   │   Result      │     Plugin      │
│  Repository │  Handlers   │   Processors  │     System      │
│             │             │               │                 │
└─────────────┴─────────────┴───────────────┴─────────────────┘

指纹管理设计

XMap 使用单例模式实现 FingerprintManager，确保多任务共享指纹库：

// 获取指纹管理器单例
func GetFingerprintManager(options *FingerprintOptions) *FingerprintManager {
    // 单例实现确保指纹库只加载一次
    // ...
    return fingerprintManagerInstance
}

扫描引擎设计

XMap 提供统一的扫描接口，支持单个和批量目标扫描：

// Scanner 定义扫描器接口
type Scanner interface {
    // 执行单个目标扫描
    Scan(ctx context.Context, target string, opts ...ScanOption) (*Result, error)
    
    // 执行批量目标扫描
    BatchScan(ctx context.Context, targets []string, opts ...ScanOption) ([]*Result, error)
}

工作池设计

为支持高效的并发扫描，XMap 实现了工作池机制，可根据需要动态调整并发度。

📋 项目结构

xmap/
├── pkg/                      # 公共包
│   ├── api/                  # API接口
│   ├── model/                # 数据模型
│   ├── probe/                # 探针定义
│   ├── scanner/              # 扫描引擎
│   └── web/                  # Web扫描
├── examples/                 # 使用示例
│   ├── batch/                # 批量扫描示例
│   └── simple/               # 简单扫描示例
├── test/                     # 测试代码
├── main.go                   # 主程序入口
├── go.mod                    # Go模块定义
└── README.md                 # 项目文档