github.com/vitaliitsarov/fingerprint-injector-go

Fingerprint Injector for Golang (chromedp)

Библиотека для инжектирования и модификации browser fingerprint при использовании chromedp в Golang. Аналог популярных Node.js решений типа fingerprint-injector.

🎯 Возможности

• ✅ Полная модификация browser fingerprint
• ✅ Поддержка всех основных параметров (User-Agent, WebGL, Canvas, Screen, Timezone и др.)
• ✅ Защита от Canvas fingerprinting с помощью шума
• ✅ Отключение/модификация WebRTC
• ✅ Скрытие признаков автоматизации (webdriver, chrome.runtime)
• ✅ Готовые пресеты для разных ОС и браузеров
• ✅ Простой API
• ✅ Полная интеграция с chromedp

📦 Установка

go get github.com/vitaliitsarov/fingerprint-injector-go

🚀 Быстрый старт

Базовое использование

package main

import (
    "context"
    "log"

    "github.com/chromedp/chromedp"
    fp "github.com/vitaliitsarov/fingerprint-injector-go"
)

func main() {
    ctx, cancel := chromedp.NewContext(context.Background())
    defer cancel()

    // Используем готовый preset
    fingerprint := fp.NewChrome119Windows11()

    // Создаем инжектор
    injector := fp.NewInjector(fingerprint)

    // Применяем fingerprint
    err := chromedp.Run(ctx,
        injector.ApplyAll(ctx),
        chromedp.Navigate("https://example.com"),
    )

    if err != nil {
        log.Fatal(err)
    }
}

Кастомный fingerprint

fingerprint := &fp.Fingerprint{
    UserAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64)...",
    Platform:  "Win32",
    Vendor:    "Google Inc.",
    Language:  "ru-RU",
    Languages: []string{"ru-RU", "ru", "en"},
    Screen: &fp.Screen{
        Width:            1920,
        Height:           1080,
        ColorDepth:       24,
        DevicePixelRatio: 1.0,
    },
    Timezone: &fp.Timezone{
        ID:     "Europe/Moscow",
        Offset: -180,
    },
    WebGL: &fp.WebGL{
        Vendor:   "Google Inc. (NVIDIA)",
        Renderer: "ANGLE (NVIDIA GeForce RTX 3080)",
    },
    Canvas: &fp.Canvas{
        Noise: 0.02, // Уровень шума
    },
    WebRTC: &fp.WebRTC{
        Disable: true, // Отключить WebRTC
    },
    HardwareConcurrency: 16,
    DeviceMemory:        32,
}

injector := fp.NewInjector(fingerprint)

🎨 Готовые пресеты

Библиотека включает готовые пресеты для разных платформ:

• NewChrome119Windows11() - Chrome 119 на Windows 11
• NewChrome119MacOS() - Chrome 119 на MacOS
• NewChrome119Linux() - Chrome 119 на Linux
• NewChrome119Android() - Chrome 119 на Android

📋 Параметры Fingerprint

Основные параметры

Параметр	Описание
UserAgent	User-Agent строка
Platform	Платформа (Win32, MacIntel, Linux x86_64)
Vendor	Производитель браузера
Language	Основной язык
Languages	Список языков
HardwareConcurrency	Количество процессорных ядер
DeviceMemory	Объем памяти устройства (GB)

Screen (Экран)

Screen: &fp.Screen{
    Width:            1920,
    Height:           1080,
    AvailWidth:       1920,
    AvailHeight:      1040,
    ColorDepth:       24,
    PixelDepth:       24,
    DevicePixelRatio: 1.0,
}

WebGL

WebGL: &fp.WebGL{
    Vendor:           "Google Inc. (NVIDIA)",
    Renderer:         "ANGLE (NVIDIA GeForce RTX 3080)",
    UnmaskedVendor:   "NVIDIA Corporation",
    UnmaskedRenderer: "NVIDIA GeForce RTX 3080",
}

Canvas Protection

Canvas: &fp.Canvas{
    Noise: 0.02, // 0.0 - 1.0, уровень шума для защиты от fingerprinting
}

WebRTC

WebRTC: &fp.WebRTC{
    Disable:  true,               // Полностью отключить
    PublicIP: "8.8.8.8",          // Подменить публичный IP
    LocalIP:  "192.168.1.100",    // Подменить локальный IP
}

Timezone

Timezone: &fp.Timezone{
    ID:     "Europe/Moscow",  // IANA timezone ID
    Offset: -180,             // Смещение в минутах
}

Battery

Battery: &fp.Battery{
    Charging:        false,
    ChargingTime:    0,
    DischargingTime: 18000,
    Level:           0.75,
}

🛡️ Stealth режим

Для максимальной защиты от детекции используйте следующие настройки chromedp:

opts := append(chromedp.DefaultExecAllocatorOptions[:],
    chromedp.Flag("headless", false),
    chromedp.Flag("disable-blink-features", "AutomationControlled"),
    chromedp.Flag("exclude-switches", "enable-automation"),
    chromedp.Flag("disable-extensions", false),
    chromedp.Flag("disable-dev-shm-usage", true),
    chromedp.UserDataDir("./chrome-data"),
)

allocCtx, cancel := chromedp.NewExecAllocator(context.Background(), opts...)
defer cancel()

ctx, cancel := chromedp.NewContext(allocCtx)
defer cancel()

// Используем fingerprint с отключенным WebRTC и повышенным шумом
fingerprint := fp.NewChrome119Windows11()
fingerprint.WebRTC.Disable = true
fingerprint.Canvas.Noise = 0.05

injector := fp.NewInjector(fingerprint)

📖 Примеры

В папке examples/ вы найдете полные примеры использования:

• examples/basic/ - Базовое использование с preset
• examples/custom/ - Использование кастомного fingerprint
• examples/stealth/ - Максимальная защита от детекции

Запуск примеров:

cd examples/basic
go run main.go

🧪 Тестирование

Проверить качество fingerprint можно на следующих сайтах:

• https://browserleaks.com/canvas
• https://browserleaks.com/webgl
• https://bot.sannysoft.com/
• https://arh.antoinevastel.com/bots/areyouheadless
• https://deviceandbrowserinfo.com/are_you_a_bot
• https://amiunique.org/

🔧 API Reference

Создание инжектора

func NewInjector(fingerprint *Fingerprint) *Injector

Методы Injector

• ApplyAll(ctx context.Context) - Применить все настройки fingerprint
• Inject(ctx context.Context) - Инжектировать JavaScript код
• SetUserAgentOverride(ctx context.Context) - Установить User-Agent через CDP
• SetTimezoneOverride(ctx context.Context) - Установить Timezone через CDP
• GetInjectionScript() - Получить JavaScript код для инжектирования

Создание Fingerprint

// Из preset
fp := fp.NewChrome119Windows11()

// Дефолтный
fp := fp.NewDefaultFingerprint()

// Кастомный
fp := &fp.Fingerprint{ /* ... */ }

🤝 Вклад

Пул реквесты приветствуются! Для крупных изменений, пожалуйста, сначала откройте issue для обсуждения.

📝 Лицензия

MIT

⚠️ Дисклеймер

Этот инструмент предназначен только для легитимных целей, таких как:

• Тестирование защиты от ботов
• Автоматизация тестирования
• Исследование browser fingerprinting

Не используйте для обхода систем защиты или других незаконных действий.

🌟 Благодарности

Вдохновлено проектами:

• puppeteer-extra-plugin-stealth
• fingerprint-injector (Node.js)
• FingerprintJS

Made with ❤️ for the Go community