Данные конфигурации, не заданные пользователем, будут автоматически заполнены с использованием отпечатков [BrowserForge](https://github.com/daijro/browserforge), которые имитируют статистическое распределение характеристик устройств в реальном трафике.

[[Посмотреть реализованные свойства](https://camoufox.com/fingerprint/)]

---

## Использование Python

Camoufox совместим с вашим существующим кодом Playwright. Вам нужно только изменить инициализацию браузера.

**Sync API**```python
from camoufox.sync_api import Camoufox

with Camoufox() as browser:
    page = browser.new_page()
    page.goto("https://example.com")

[[Установка и использование](https://camoufox.com/python/)]

### Полноценное использование спуфинга оборудования

Для стабильных версий следует всегда использовать основной pip-пакет [`camoufox`](https://pypi.org/project/camoufox/). Однако если вы хотите использовать контекстные отпечатки и спуфинг оборудования, используйте пакет [`cloverlabs-camoufox`](https://pypi.org/project/cloverlabs-camoufox/). Этот пакет обновляется с каждым релизом, тогда как официальный пакет выходит с задержкой.

Убедитесь, что вы используете виртуальное окружение, чтобы избежать конфликтов между этими двумя пакетами.

**Установка**```bash
pip install cloverlabs-camoufox

**Использование** — API идентичен исходному пакету:```python
from camoufox.sync_api import Camoufox

with Camoufox() as browser:
    page = browser.new_page()
    page.goto("https://example.com")

Библиотека автоматически выбирает маршрут по версии бинарного файла: Firefox ≥ 149 загружает `fingerprint-presets-v150.json` (312 пресетов, охватывающих v149–v152, 67 macOS / 180 Windows / 65 Linux); более старые бинарные файлы возвращаются к исходному пакету. Строки UA переписываются, чтобы соответствовать активному бинарному файлу, поэтому согласие безопасно для всех версий. Передайте словарь пресетов вместо `True`, чтобы зафиксировать конкретный отпечаток.

---

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

Ниже приведён список исправлений и функций, реализованных в Camoufox.

### Подмена отпечатка браузера

- Подмена свойств навигатора (устройство, браузер, локаль и т. д.)
- Поддержка эмуляции размера экрана, разрешения и т. д.
- Подмена параметров WebGL, поддерживаемых расширений, атрибутов контекста и форматов точности шейдеров.
- Подмена размеров внутреннего и внешнего окна просмотра
- Подмена частоты дискретизации AudioContext, задержки вывода и максимального количества каналов
- Подмена голосов устройств и скорости воспроизведения
- Подмена количества доступных микрофонов, веб-камер и динамиков.
- Сетевые заголовки (Accept-Languages и User-Agent) подменяются в соответствии со свойствами навигатора
- Подмена IP WebRTC на уровне протокола
- Подмена геолокации, часового пояса и локали
- Подмена Battery API
- и т. д.

### Скрытые исправления

- Избегает утечек выполнения в основном контексте страницы. Весь JavaScript агента страницы изолирован в песочнице
- Избегает утечек контекста выполнения фреймов
- Исправляет обнаружение `navigator.webdriver`
- Исправляет обнаружение безголового режима Firefox по типу указателя ([#26](https://github.com/daijro/camoufox/issues/26))
- Удалены потенциально утекающие исправления анти-зума/обработки мета-вьюпорта
- Использует нестандартные размеры экрана и окна
- Повторное включение изоляции контента Fission
- Повторное включение PDF.js
- Изменены другие утекающие свойства конфигурации
- Движение курсора, подобное человеческому

### Защита от отпечатков шрифтов

- Автоматически использует правильные системные шрифты для вашего User Agent
- Включает системные шрифты Windows, Mac и Linux
- Предотвращает получение отпечатка метрик шрифта путём случайного смещения межбуквенного интервала

### Поддержка Playwright

- Пользовательская реализация Playwright для последней версии Firefox
- Различные исправления конфигурации для обхода обнаружения ботов

### Деблоатинг / Оптимизации

- Вырезаны / отключены _очень, очень многие_ сервисы Mozilla. Работает быстрее, чем оригинальный Mozilla Firefox, и использует меньше памяти (200 МБ)
- Исправления из LibreWolf и Ghostery для удаления телеметрии и блоата
- Конфигурация деблоатинга из PeskyFox, LibreWolf и других
- Оптимизации скорости и сети из FastFox
- Удалены все CSS-анимации
- Минималистичное оформление
- и т. д.

### Дополнения

- Загрузка дополнений Firefox без сервера отладки путём передачи списка путей в свойство `addons`
- Добавлен uBlock Origin с пользовательскими фильтрами приватности
- Дополнениям не разрешается открывать вкладки
- Дополнения автоматически включаются в режиме приватного просмотра
- Дополнения автоматически закрепляются на панели инструментов
- Исправляет утечки DNS с предварительной выборкой uBO

### Интерфейс Python

- Автоматически генерирует и внедряет уникальные характеристики устройства в Camoufox на основе их реального распределения
- Внедрение и ротация отпечатка WebGL
- Использует правильные системные шрифты, субпиксельное сглаживание и хинтинг в зависимости от целевой ОС
- Избегает обнаружения прокси путём вычисления целевой геолокации, часового пояса и локали из целевого региона прокси
- Вычисляет и подменяет язык браузера на основе распределения носителей языка в целевом регионе прокси
- Размещение на удалённом сервере для использования Camoufox с другими языками, поддерживающими Playwright
- Встроенный буфер виртуального дисплея для запуска Camoufox с отображением на безголовом сервере
- Переключение загрузки изображений, WebRTC и WebGL
- и т. д.

> [!NOTE]
> Camoufox **не** полностью поддерживает внедрение отпечатков Chromium. Некоторые WAF (например, [Interstitial](https://nopecha.com/demo/cloudflare)) проверяют поведение движка Spidermonkey, которое невозможно подделать.

---

# Обзор скрытности

## Как Camoufox скрывает свою библиотеку автоматизации

> [!WARNING]
> **Текущий статус на 2026 год**:
> Был годичный перерыв в поддержке из-за личных обстоятельств. Производительность Camoufox снизилась из-за базовой версии Firefox и недавно обнаруженных несоответствий в отпечатках. **Camoufox находится в активной разработке.**

В Camoufox весь код внутреннего агента страницы Playwright изолирован и изолирован. Это делает невозможным для страницы обнаружить присутствие Playwright с помощью проверок JavaScript.

Обычно Playwright внедряет в страницу некоторый JavaScript, такой как `window.__playwright__binding__`, и выполняет такие действия, как запрос элементов, оценка JavaScript или запуск скриптов инициализации, которые могут быть обнаружены веб-сайтами. В Camoufox эти действия обрабатываются в изолированной области вне страницы. Другими словами, веб-сайты больше не могут «видеть» какой-либо JavaScript, который Playwright обычно внедряет. Это полностью предотвращает следы Playwright.

Однако, даже скрывая свою библиотеку автоматизации, Camoufox не застрахован от несоответствий при ротации отпечатков. Для выявления и исправления таких проблем всё ещё требуется поддержка.

### Взаимодействие со страницами

Антибот-системы также запускают клиентские скрипты для мониторинга вашего поведения. Например, они ищут закономерности в движениях мыши, кликах, прокрутке и временных интервалах между действиями.

<video controls src="https://github.com/user-attachments/assets/6d33d6af-3537-4603-bf24-6bd3f4f8f455" width="200px" loop muted></video>

Camoufox старается изо всех сил со своим алгоритмом движения мыши, подобным человеческому. Алгоритм естественного движения изначально был взят из [HumanCursor от riflosnake](https://github.com/riflosnake/HumanCursor) и переписан на C++ с модификациями для более точных траекторий с учётом расстояния.

Однако это не идеально. Он всё ещё может быть обнаружен при достаточно сложном анализе. (В разработке на будущее)

---

## Как Camoufox меняет идентичности

AI-агентам необходимо работать в разных сессиях, не получая блокировок или ограничений скорости. Ротации IP-адреса недостаточно — каждая сессия браузера передаёт тысячи сигналов, создающих уникальный **отпечаток**. Веб-сайт может видеть вашу ОС, GPU, разрешение экрана, шрифты, часовой пояс и многое другое. Если эти сигналы несовместимы или необычны, вы будете заблокированы.

### Распределение рыночных долей

Даже если вы меняете IP-адрес для каждого запущенного экземпляра бота, межсетевые экраны могут использовать машинное обучение для анализа входящего веб-трафика на предмет аномалий. Если доля Linux составляла 5%, но внезапно стала 20%, это тревожный сигнал. Они потребуют от всех пользователей Linux проходить капчу без исключений.

Camoufox использует генератор отпечатков [BrowserForge](https://github.com/daijro/browserforge), чтобы имитировать статистическое распределение данных устройств в реальном трафике. Например, Camoufox сделает ваш браузер похожим на пользователя Linux в 5% случаев. Из этих 5% в 9,5% случаев будет подделано разрешение экрана 2560x1440, а в 27,5% — GPU Intel HD.

### Как можно обнаружить Camoufox?

Camoufox может подделывать отпечатки с правильной рыночной долей. Однако **отпечатки также должны быть внутренне согласованы.** Пользовательский агент Windows с Apple M1 GPU, пользовательский агент macOS с рендерером Windows DirectX и мобильное устройство с разрешением рабочего стола — всё это невозможно и будет отмечено как подозрительное.

Из тысяч возможных точек данных, которые необходимо изменить для создания правдоподобного поддельного отпечатка, где каждое изменение должно быть согласовано с другими, Camoufox не всегда преуспевает. Антибот-провайдеры неоднократно тестируют Camoufox, чтобы найти хотя бы одну уникальную несостыковку, а затем сразу же обновляют свои фоновые скрипты для её проверки.

---

## Сравнение Camoufox с другими решениями

### Решения на основе JavaScript

В прошлом разработчики пытались внедрять JavaScript для подмены этих значений, но это ненадёжно, поскольку JavaScript не может подделать всё. Неполное покрытие приводит к несовместимым отпечаткам. Например, антибот-система заблокирует вас, если User Agent в сетевом запросе не совпадает с User Agent в навигаторе.

Кроме того, любой внедрённый JavaScript так или иначе обнаруживается. Антибот-системы могут проверить, не показывает ли `Object.getOwnPropertyDescriptor` перезаписанное свойство, не возвращает ли `toString()` функции `[native code]` (что указывает на перехват), или не отличаются ли данные в контексте окна от данных в рабочем потоке. Обходные пути помогают лишь до определённого момента, но при достаточном углублении всегда можно найти способ обнаружения внедрения JS.

#### Подход Camoufox

Поскольку Camoufox перехватывает вызовы на уровне реализации C++ браузера, все перехваченные объекты и свойства выглядят нативными. Отсутствует обнаружение перехвата JavaScript.

Camoufox также старается генерировать согласованные и правдоподобные отпечатки с помощью Browserforge. Однако это всё ещё может быть обнаружено с помощью сложных методов определения несоответствий (как описано выше).

<hr width=50>

### Библиотеки на основе CDP

CDP (Chrome DevTools Protocol) — это протокол автоматизации, встроенный в Chromium и Firefox. Однако CDP не пытается скрыть тот факт, что это протокол автоматизации, и раскрывает многие свои функции в области страницы. Некоторые распространённые методы: проверка `navigator.webdriver` на true, обнаружение чтения отладчика стека, проверка переменных, которые ChromeDriver внедряет в объект document для внутренней связи, и многое другое.

#### Подход Camoufox

В то время как Playwright использует CDP для управления Chromium, для Firefox он использует _Juggler_. Juggler — это пользовательский протокол, разработанный до того, как Firefox поддержал CDP ([оригинальный репозиторий](https://github.com/puppeteer/juggler)). Это отдельный модуль внутри Firefox, не являющийся частью его ядра. Это упрощает его редактирование и контроль над тем, что раскрывается странице.

Camoufox модифицирует Juggler, предоставляя ему собственную изолированную «копию» страницы для работы. Playwright может свободно читать и редактировать свою собственную версию страницы. Всё выглядит нормально для Playwright, но реальная страница совершенно не затрагивается этими изменениями. Страница также не может обнаружить, когда что-то читается (с помощью трюков вроде перехвата геттеров) или добавляются прослушиватели для наблюдения за элементами.

Кроме того, Juggler отправляет свои входные данные напрямую через оригинальные обработчики ввода Firefox, что означает, что они обрабатываются точно так же, как если бы вы использовали браузер обычным образом. Camoufox также модифицирует безголовый режим Firefox, чтобы он выглядел так же, как при работе в обычном окне. Однако в качестве запасного варианта библиотека Python может запускать Camoufox в [виртуальном дисплее](https://camoufox.com/python/virtual-display/), если безголовый режим когда-либо даст утечку.

---

<h1 align="center">Система сборки</h1>

> [!WARNING]
> Содержимое ниже предназначено для тех, кто заинтересован в сборке и отладке Camoufox. Инструкции по использованию Playwright см. [здесь](https://github.com/daijro/camoufox/tree/main/pythonlib#camoufox-python-interface).

### Обзор

Вот диаграмма системы сборки и связанных с ней make-команд:```mermaid
graph TD
    FFSRC[Firefox Source] -->|make fetch| REPO

    subgraph REPO[Camoufox Repository]
        PATCHES[Fingerprint masking patches]
        ADDONS[uBlock & B.P.C.]
        DEBLOAT[Debloat/optimizations]
        SYSTEM_FONTS[Win, Mac, Linux fonts]
        JUGGLER[Patched Juggler]
    end

    subgraph Local
    REPO -->|make dir| PATCH[Patched Source]
    PATCH -->|make build| BUILD[Built]
    BUILD -->|make package-linux| LINUX[Linux Portable]
    BUILD -->|make package-windows| WIN[Windows Portable]
    BUILD -->|make package-macos| MAC[macOS Portable]
    end

git clone --depth 1 --branch main https://github.com/daudix/camoufox.git
``````bash
git clone --depth 1 https://github.com/daijro/camoufox
cd camoufox

Перед начальной загрузкой (bootstrapping) установите системные зависимости сборки с помощью вспомогательного скрипта. Он определяет вашу платформу и устанавливает всё необходимое для сборки (Python ≥ 3.11, Rust, `aria2`, `p7zip`, `go`, `msitools`, `wget`, `sqlite` и основные инструменты сборки) с использованием соответствующего менеджера пакетов — Homebrew на macOS или `apt`/`dnf`/`pacman` на Linux:```bash
bash scripts/install-deps.sh

Наконец, вы можете собрать и упаковать Camoufox следующей командой:```bash
python3 multibuild.py --target linux windows macos --arch x86_64 arm64 i686