Los datos de configuración no establecidos por el usuario se completarán automáticamente mediante huellas de [BrowserForge](https://github.com/daijro/browserforge), que imitan la distribución estadística de las características de los dispositivos en el tráfico real.

[[Ver propiedades implementadas](https://camoufox.com/fingerprint/)]

---

## Uso en Python

Camoufox es compatible con tu código Playwright existente. Solo tienes que cambiar la inicialización de tu navegador.

**API síncrona**```python
from camoufox.sync_api import Camoufox

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

[[Instalación y uso](https://camoufox.com/python/)]

### Aprovechando al máximo el Hardware Spoofing

Para versiones estables, siempre debes usar el paquete pip principal [`camoufox`](https://pypi.org/project/camoufox/). Sin embargo, si quieres aprovechar las huellas digitales por contexto y el hardware spoofing, usa el paquete [`cloverlabs-camoufox`](https://pypi.org/project/cloverlabs-camoufox/). Este paquete se actualiza con cada lanzamiento, mientras que el paquete oficial se publica con retraso.

Asegúrate de usar un entorno virtual para evitar conflictos entre los dos paquetes.

**Instalación**```bash
pip install cloverlabs-camoufox

**Uso** — la API es idéntica al paquete upstream:```python
from camoufox.sync_api import Camoufox

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

La biblioteca enruta automáticamente según la versión del binario: Firefox ≥ 149 carga `fingerprint-presets-v150.json` (312 presets que cubren v149–v152, 67 macOS / 180 Windows / 65 Linux); los binarios más antiguos recurren al paquete original. Las cadenas UA se reescriben para coincidir con el binario activo, por lo que optar por esta función es seguro entre versiones. Pasa un dict de preset en lugar de `True` para fijar una huella específica.

---

## Capacidades

A continuación se muestra una lista de parches y funciones implementados en Camoufox.

### Suplantación de huella digital

- Suplantación de propiedades del Navigator (dispositivo, navegador, configuración regional, etc.)
- Compatibilidad para emular tamaño de pantalla, resolución, etc.
- Suplanta parámetros de WebGL, extensiones compatibles, atributos de contexto y formatos de precisión de shaders.
- Suplanta los tamaños de viewport internos y externos de la ventana
- Suplanta la frecuencia de muestreo de AudioContext, la latencia de salida y el número máximo de canales
- Suplanta las voces del dispositivo y las velocidades de reproducción
- Suplanta la cantidad de micrófonos, cámaras web y altavoces disponibles.
- Las cabeceras de red (Accept-Languages y User-Agent) se suplantan para coincidir con las propiedades del navigator
- Suplantación de IP WebRTC a nivel de protocolo
- Suplantación de geolocalización, zona horaria y configuración regional
- Suplantación de la API de batería
- etc.

### Parches de sigilo

- Evita fugas de ejecución en el mundo principal. Todo el javascript del agente de página está en un sandbox.
- Evita fugas en el contexto de ejecución de los frames
- Corrige la detección de `navigator.webdriver`
- Corrige la detección de Firefox headless mediante el tipo de puntero ([#26](https://github.com/daijro/camoufox/issues/26))
- Se eliminaron los parches de manejo de anti-zoom/viewport meta que podían filtrar información
- Usa tamaños de pantalla y ventana no predeterminados
- Vuelve a habilitar los aislamientos de contenido de Fission
- Vuelve a habilitar PDF.js
- Otras propiedades de configuración que filtraban información fueron modificadas
- Movimiento del cursor similar al humano

### Anti huella de fuentes

- Usa automáticamente las fuentes del sistema correctas para tu User Agent
- Incluye las fuentes del sistema de Windows, Mac y Linux
- Previene la huella de métricas de fuentes desplazando aleatoriamente el espaciado entre letras

### Compatibilidad con Playwright

- Implementación personalizada de Playwright para la última versión de Firefox
- Varios parches de configuración para evadir la detección de bots

### Debloat/Optimizaciones

- Eliminó/deshabilitó _muchísimos_ servicios de Mozilla. Se ejecuta más rápido que Mozilla Firefox original y usa menos memoria (200mb)
- Parches de LibreWolf y Ghostery para ayudar a eliminar telemetría y bloat
- Configuración de debloat de PeskyFox, LibreWolf y otros
- Optimizaciones de velocidad y red de FastFox
- Eliminó todas las animaciones CSS
- Tema minimalista
- etc.

### Complementos

- Carga complementos de Firefox sin un servidor de depuración pasando una lista de rutas a la propiedad `addons`
- Añadido uBlock Origin con filtros de privacidad personalizados
- Los complementos no pueden abrir pestañas
- Los complementos se habilitan automáticamente en el modo de Navegación Privada
- Los complementos se fijan automáticamente a la barra de herramientas
- Corrige fugas de DNS con la precarga de uBO

### Interfaz de Python

- Genera e inyecta automáticamente características de dispositivo únicas en Camoufox basándose en su distribución en el mundo real
- Inyección y rotación de huellas WebGL
- Usa las fuentes del sistema correctas y el antialiasing y hinting de subpíxeles según tu sistema operativo objetivo
- Evita la detección de proxy calculando tu geolocalización, zona horaria y configuración regional objetivo a partir de la región objetivo de tu proxy
- Calcula y suplanta el idioma del navegador basándose en la distribución de hablantes del idioma en la región objetivo del proxy
- Alojamiento en servidor remoto para usar Camoufox con otros lenguajes compatibles con Playwright
- Búfer de pantalla virtual integrado para ejecutar Camoufox con interfaz gráfica en un servidor headless
- Activar/desactivar la carga de imágenes, WebRTC y WebGL
- etc.

> [!NOTE]
> Camoufox **no** es compatible totalmente con la inyección de huellas de Chromium. Algunos WAF (como [Interstitial](https://nopecha.com/demo/cloudflare)) prueban el comportamiento del motor Spidermonkey, algo imposible de suplantar.

---

# Descripción general del sigilo

## Cómo Camoufox oculta su biblioteca de automatización

> [!WARNING]
> **Estado actual a partir de 2026**:
> Ha habido un año de pausa en el mantenimiento debido a una situación personal. El rendimiento de Camoufox se ha reducido debido a la versión base de Firefox y a inconsistencias de huella recién descubiertas. **Camoufox está actualmente en desarrollo activo.**

En Camoufox, todo el código del Page Agent interno de Playwright está en un sandbox y aislado. Esto hace imposible que una página detecte la presencia de Playwright mediante la inspección de JavaScript.

Normalmente, Playwright inyecta algo de JavaScript en la página, como `window.__playwright__binding__`, y lo hace para realizar acciones como consultar elementos, evaluar JavaScript o ejecutar scripts de inicialización, lo cual puede ser detectado por los sitios web. En Camoufox, estas acciones se manejan en un ámbito aislado fuera de la página. En otras palabras, los sitios web ya no pueden "ver" ningún JavaScript que Playwright inyectaría normalmente. Esto evita por completo cualquier rastro de Playwright.

Sin embargo, incluso ocultando su biblioteca de automatización, Camoufox no es inmune a las inconsistencias en la rotación de huellas. Esto aún requiere mantenimiento para detectarlas y corregirlas.

### Interacciones de página

Los sistemas antibots también ejecutan scripts del lado del cliente para monitorear tu comportamiento. Por ejemplo, buscan patrones en los movimientos del ratón, clics, desplazamiento y el tiempo entre acciones.

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

Camoufox hace todo lo posible con su algoritmo de movimiento de ratón similar al humano. El algoritmo de movimiento natural proviene originalmente de [HumanCursor de riflosnake](https://github.com/riflosnake/HumanCursor) y se ha reescrito en C++ y modificado para trayectorias más conscientes de la distancia.

Sin embargo, no es perfecto. Aún puede detectarse con un análisis lo suficientemente sofisticado. (Trabajo en curso para el futuro)

---

## Cómo Camoufox rota identidades

Los agentes de IA necesitan operar a través de muchas sesiones sin que se les marque ni se les limite la velocidad. Rotar tu dirección IP no es suficiente: cada sesión de navegador lleva miles de señales que crean una **huella** única. Un sitio web puede ver tu sistema operativo, GPU, resolución de pantalla, fuentes, zona horaria y más. Si esas señales son inconsistentes o inusuales, te bloquean.

### Distribución de cuota de mercado

Incluso si estás rotando tu IP para cada instancia de bot en ejecución, los firewalls de acceso web pueden usar aprendizaje automático para analizar el tráfico web entrante y detectar si es anormal. Si la cuota de mercado de Linux fuera del 5% y de repente es del 20%, es una señal de alerta. Exigirán incondicionalmente a todos los usuarios de Linux que completen un captcha.

Camoufox usa el generador de huellas de [BrowserForge](https://github.com/daijro/browserforge) para imitar la distribución estadística de los datos de dispositivos en el tráfico del mundo real. Por ejemplo, Camoufox hará que tu navegador parezca un usuario de Linux el 5% de las veces. De ese 5%, suplantará una resolución de pantalla 2560x1440 el 9.5% de las veces y una GPU Intel HD el 27.5% de las veces.

### ¿Cómo puede detectarse Camoufox?

Camoufox puede suplantar huellas con una cuota de mercado correcta. Sin embargo, **las huellas también deben ser internamente consistentes.** Un user agent de Windows con una GPU Apple M1, un user agent de macOS con un renderizador DirectX de Windows y un dispositivo móvil con una resolución de pantalla de escritorio son todos imposibles, y se marcarán como sospechosos.

De los miles de puntos de datos posibles que deben cambiarse para crear una huella suplantada creíble, donde cada cambio debe ser consistente con los demás, Camoufox no siempre tiene éxito. Los proveedores antibots prueban Camoufox una y otra vez para encontrar aunque sea una única inconsistencia, y luego actualizan inmediatamente sus scripts en segundo plano para detectarla.

---

## ¿Cómo se compara Camoufox con otras soluciones?

### Soluciones basadas en JavaScript

En el pasado, los desarrolladores intentaron inyectar JavaScript para suplantar estos valores, pero no funciona de forma fiable ya que JavaScript no puede suplantarlo todo. Una cobertura incompleta causa huellas inconsistentes. Por ejemplo, un sistema antibots te marcará si el User Agent de tu solicitud de red no coincide con el User Agent de tu navigator.

Además, todo JavaScript inyectado es detectable de alguna manera. Los sistemas antibots pueden comprobar si `Object.getOwnPropertyDescriptor` revela una propiedad sobrescrita, si el `toString()` de una función ya no devuelve `[native code]` (lo que revela que fue secuestrada), o si los datos del contexto de la ventana no coinciden con el contexto del hilo worker. Las soluciones alternativas solo te llevan hasta cierto punto, pero siempre habrá una forma de detectar la inyección de JS si se busca lo suficientemente profundo.

#### El enfoque de Camoufox

Dado que Camoufox intercepta las llamadas en el nivel de implementación C++ del navegador, todos los objetos y propiedades secuestrados parecen nativos. No hay secuestro de JavaScript que detectar.

Camoufox también intenta generar huellas consistentes y creíbles con Browserforge. Sin embargo, esto aún puede ser detectado por métodos complejos de detección de huellas, como la discordancia de datos (como se describió anteriormente).

<hr width=50>

### Bibliotecas basadas en CDP

CDP (Chrome DevTools Protocol) es un protocolo de automatización integrado en Chromium y Firefox. Sin embargo, CDP no hace ningún esfuerzo por ocultar el hecho de que es un protocolo de automatización y expone gran parte de su funcionalidad en el ámbito de la página. Algunos métodos comunes son comprobar si `navigator.webdriver` es true, detectar cuando lee la pila del depurador, buscar variables que ChromeDriver inyecta en el objeto document para la comunicación interna, y más.

#### El enfoque de Camoufox

Mientras Playwright usa CDP para controlar Chromium, usa _Juggler_ para Firefox. Juggler es un protocolo personalizado desarrollado antes de que Firefox soportara CDP ([repositorio original](https://github.com/puppeteer/juggler)). Es un módulo distinto dentro de Firefox y no forma parte del navegador principal. Esto facilita editar y controlar lo que se revela a la página.

Camoufox parchea Juggler para darle su propia "copia" aislada de la página con la que trabajar. Playwright puede leer y editar su propia versión de la página libremente. Todo parece funcionar con normalidad, pero la página real no se ve afectada en absoluto por estos cambios. La página tampoco puede detectar cuándo se están leyendo cosas (mediante trucos como secuestrar getters) ni cuándo se añaden listeners para vigilar elementos.

Adicionalmente, Juggler envía sus entradas directamente a través de los manejadores de entrada de usuario originales de Firefox, lo que significa que se manejan exactamente igual que si estuvieras usando el navegador normalmente. Camoufox también parchea el modo headless de Firefox para que parezca lo mismo que si se estuviera ejecutando en una ventana normal. Pero como respaldo, la biblioteca de Python puede ejecutar Camoufox en un [display virtual](https://camoufox.com/python/virtual-display/) si el modo headless llegara a filtrar información.

---

<h1 align="center">Sistema de compilación</h1>

> [!WARNING]
> El contenido a continuación está destinado a quienes estén interesados en compilar y depurar Camoufox. Para instrucciones de uso de Playwright, consulta [aquí](https://github.com/daijro/camoufox/tree/main/pythonlib#camoufox-python-interface).

### Descripción general

Aquí hay un diagrama del sistema de compilación y sus comandos make asociados:```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

A continuación, compile el código fuente de Camoufox con el siguiente comando:```bash
make dir

> [!NOTE]
> El instalador de dependencias hasta ahora solo se ha probado en macOS.

Después de eso, tienes que hacer bootstrap de tu sistema para poder compilar Camoufox. Solo tienes que hacerlo una vez. Se hace ejecutando el siguiente comando:```bash
make bootstrap

Para compilaciones nuevas, `i686` solo es compatible con Windows. Las combinaciones de objetivo/arquitectura no compatibles se omiten.

<details>
<summary>
Parámetros de CLI
</summary>```bash
Options:
  -h, --help            show this help message and exit
  --target {linux,windows,macos} [{linux,windows,macos} ...]
                        Target platforms to build
  --arch {x86_64,arm64,i686} [{x86_64,arm64,i686} ...]
                        Target architectures to build for each platform
  --bootstrap           Bootstrap the build system
  --clean               Clean the build directory before starting

Example:
$ python3 multibuild.py --target linux windows macos --arch x86_64 arm64

2. Compile los parches de Camoufox para una plataforma y arquitectura de destino:```bash
docker run -v "$(pwd)/dist:/app/dist" camoufox-builder --target <os> --arch <arch>

Los parches se pueden editar, crear, eliminar y gestionar desde aquí.

<img src="https://assets.kitploit.com/production/public/readmes/41473/19bffc384c42fb6eb69b3ee59622daed4770cf0f11ffe39401eca57a7d2457f4.png">

### Cómo crear un parche

1. En la interfaz de desarrollador, haz clic en **Reset workspace**.
2. Realiza los cambios necesarios en la carpeta `camoufox-*/`. Puedes probar tus cambios con `make build` y `make run`.
3. Cuando hayas terminado de hacer los cambios, haz clic en **Write workspace to patch** y guarda el archivo del parche.

### Cómo trabajar con un parche existente

1. En la interfaz de desarrollador, haz clic en **Edit a patch**.
2. Selecciona el parche que quieras editar. Tu espacio de trabajo se restablecerá al estado del parche seleccionado.
3. Cuando hayas terminado de hacer los cambios, pulsa **Write workspace to patch** y sobrescribe el archivo del parche existente.

---

## Depuración de fugas

Este es un diagrama de flujo que muestra mi proceso para determinar fugas sin desofuscar el JavaScript del WAF. El método reintroduce de forma incremental las funciones de Camoufox en el código fuente de Firefox hasta que el sitio de prueba lo detecta.

Este proceso requiere un sistema Linux y asume que tienes instaladas las herramientas de compilación de Firefox (consulta [aquí](https://github.com/daijro/camoufox?tab=readme-ov-file#build-cli)).

<details>
<summary>
Ver diagrama de flujo...
</summary>```mermaid
flowchart TD
    A[Start] --> B[Does website flag in the official Firefox?]
    B -->|Yes| C[Likely bad IP/rate-limiting. If the website fails on both headless and headful mode on the official Firefox distribution, the issue is not with the browser.]
    B -->|No| D["Run make ff-dbg(1) and build(2) a clean distribution of Firefox. Does the website flag in Firefox **headless** mode(4)?"]
    D -->|Yes| E["Does the website flag in headful mode(3) AND headless mode(4)?"]
    D -->|No| F["Open the developer UI(5), apply config.patch, then rebuild(2). Does the website still flag(3)?"]
    E -->|No| G["Enable privacy.resistFingerprinting in the config(6). Does the website still flag(3)?"]
    E -->|Yes| C
    G -->|No| H["In the config(6), enable FPP and start omitting overrides until you find the one that fixed the leak."]
    G -->|Yes| I[If you get to this point, you may need to deobfuscate the Javascript behind the website to identify what it's testing.]
    F -->|Yes| K["Open the developer UI, apply the playwright bootstrap patch, then rebuild. Does it still flag?"]
    F -->|No| J["Omit options from camoufox.cfg(6) and rerun(3) until you find the one causing the leak."]
    K -->|No| M[Juggler needs to be debugged to locate the leak.]
    K -->|Yes| L[The issue has nothing to do with Playwright. Apply the rest of the Camoufox patches one by one until the one causing the leak is found.]
    M --> I