fingerprint

README

fingerprint

高性能浏览器 TLS 指纹库，提供 200+ 浏览器指纹配置和全面的指纹识别能力。

核心特性

• 200+ 真实浏览器指纹 - Chrome、Firefox、Safari、Edge、Opera、Brave 等
• TLS 指纹分析 - JA3/JA4 指纹生成与识别
• HTTP/2 签名 - 完整的帧分析和签名匹配
• 机器学习分类 - 内置 ML 检测异常流量
• 安全防护 - 风险评分和异常检测
• Go Workspace - 模块化架构，按需导入

快速开始

go get github.com/vistone/fingerprint/modules/fingerprint

package main

import (
    "fmt"
    "github.com/vistone/fingerprint/modules/fingerprint"
)

func main() {
    // 获取随机 Chrome 指纹
    profile := fingerprint.GetRandomByBrowser(fingerprint.BrowserChrome)
    fmt.Printf("Selected: %s\n", profile.Name)
}

模块结构

modules/
├── core          # 核心类型与常量 (零依赖)
├── errors        # 规范错误包 (ErrorCode, CoreError)
├── profiles      # 200+ 浏览器指纹
├── tls           # TLS 指纹分析 (JA3/JA4)
├── http          # HTTP/2 签名分析
├── ml            # 机器学习分类器
├── defense       # 安全防护与风险评估
├── gateway       # API 网关
├── generator     # 指纹生成器
├── network       # TCP/IP 指纹 (JA4T)
├── agent         # 自治安全代理
├── config        # 配置管理桥接层
├── plugin        # 插件系统公共 API
├── kit           # 工具集 (UA 解析等)
├── frontend      # 前端静态资源
├── fingerprint   # Facade 统一入口
└── internal      # 内部实现 (扩展/安全/TCP等)

使用方式

方式一: Facade 模块 (推荐)

import "github.com/vistone/fingerprint/modules/fingerprint"

profile := fingerprint.GetRandom()
chrome := fingerprint.GetByBrowser(fingerprint.BrowserChrome)

方式二: 直接导入子模块

import (
    "github.com/vistone/fingerprint/modules/core"
    "github.com/vistone/fingerprint/modules/profiles"
)

profile, _ := profiles.Get("chrome_133")
chromeProfiles := profiles.GetByBrowser(core.BrowserChrome)

指纹覆盖

浏览器	版本范围	数量
Chrome	115-144	64
Firefox	115-140	43
Safari	16-18	48
Edge	115-134	23
Opera	100-110	12
Brave	1.60-1.72	7
移动端	iOS/Android	10
合计		207

文档

• 架构说明 - Go Workspace 架构详解
• API 文档 - 完整 API 参考
• 开发者指南 - 开发和贡献指南
  • ⚠️ 版本控制规则 - 必读开发规则
• 版本管理策略 - 版本号管理详解
• 变更日志 - 版本更新记录

示例

见 examples/ 目录：

• basic/ - 基础使用示例
• advanced/ - 高级功能示例
• random/ - 随机指纹生成

性能

• 指纹选择: O(1) 哈希表查找
• 零分配关键路径
• 并发安全设计

许可证

BSD 3-Clause License