ユーザーが設定しなかった構成データは、実際のトラフィックにおけるデバイス特性の統計的分布を模倣した[BrowserForge](https://github.com/daijro/browserforge)フィンガープリントを使用して自動的に入力されます。

[[実装されたプロパティを見る](https://camoufox.com/fingerprint/)]

---

## Pythonの使用法

Camoufoxは既存のPlaywrightコードと互換性があります。ブラウザの初期化を変更するだけで済みます。

**同期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/)]

### ハードウェアスプーフィングを最大限活用する

安定版リリースでは、メインの [`camoufox`](https://pypi.org/project/camoufox/) pip パッケージを常に使用してください。ただし、コンテキストごとのフィンガープリントやハードウェアスプーフィングを利用したい場合は、[`cloverlabs-camoufox`](https://pypi.org/project/cloverlabs-camoufox/) パッケージを使用してください。このパッケージはリリースのたびに更新されますが、公式パッケージは遅延してリリースされます。

2つのパッケージ間の競合を避けるため、仮想環境を使用していることを確認してください。

**インストール**```bash
pip install cloverlabs-camoufox

**Usage** — 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`（v149～v152をカバーする312のプリセット、macOS 67 / Windows 180 / Linux 65）を読み込みます。古いバイナリは元のバンドルにフォールバックします。UA文字列はアクティブなバイナリに一致するように書き換えられるため、オプトインはバージョン間で安全です。特定のフィンガープリントを固定するには、`True` の代わりにプリセット辞書を渡してください。

---

## 機能

以下は、Camoufox に実装されているパッチと機能のリストです。

### フィンガープリント偽装

- Navigator プロパティの偽装（デバイス、ブラウザ、ロケールなど）
- 画面サイズ、解像度などのエミュレーションのサポート
- WebGL パラメータ、サポートされている拡張機能、コンテキスト属性、シェーダー精度フォーマットの偽装
- 内部および外部ウィンドウのビューポートサイズの偽装
- AudioContext のサンプルレート、出力レイテンシ、最大チャンネル数の偽装
- デバイスの音声と再生レートの偽装
- 利用可能なマイク、Webカメラ、スピーカーの数の偽装
- ネットワークヘッダー（Accept-Languages と User-Agent）は、navigator プロパティと一致するように偽装されます
- プロトコルレベルでの WebRTC IP 偽装
- 地理位置情報、タイムゾーン、ロケールの偽装
- Battery API の偽装
- など

### ステルスパッチ

- メインワールド実行の漏洩を回避。すべてのページエージェント JavaScript はサンドボックス化されています
- フレーム実行コンテキストの漏洩を回避
- `navigator.webdriver` 検出を修正
- ポインタタイプを介した Firefox ヘッドレス検出を修正（[#26](https://github.com/daijro/camoufox/issues/26)）
- 潜在的に漏洩するアンチズーム/メタビューポート処理パッチを削除
- デフォルト以外の画面＆ウィンドウサイズを使用
- fission コンテンツ分離を再有効化
- PDF.js を再有効化
- その他の漏洩する可能性のある設定プロパティを変更
- 人間らしいカーソル移動

### フォントフィンガープリンティング対策

- ユーザーエージェントに適したシステムフォントを自動的に使用
- Windows、Mac、Linux のシステムフォントをバンドル
- 文字間隔をランダムにオフセットすることでフォントメトリクスのフィンガープリンティングを防止

### Playwright サポート

- 最新の Firefox 向け Playwright のカスタム実装
- ボット検出を回避するためのさまざまな設定パッチ

### デブロート/最適化

- 多数の Mozilla サービスを削除/無効化。オリジナルの Mozilla Firefox よりも高速に動作し、メモリ使用量も少ない（200MB）
- LibreWolf & Ghostery からのパッチでテレメトリとブロートを削除
- PeskyFox、LibreWolf などからのデブロート設定
- FastFox からの速度＆ネットワーク最適化
- すべての CSS アニメーションを削除
- ミニマルなテーマ設定
- など

### アドオン

- `addons` プロパティにパスのリストを渡すことで、デバッグサーバーなしで Firefox アドオンを読み込む
- カスタムプライバシーフィルター付きの uBlock Origin を追加
- アドオンはタブを開くことができません
- プライベートブラウジングモードでアドオンが自動的に有効化されます
- アドオンはツールバーに自動的にピン留めされます
- uBO のプリフェッチによる DNS リークを修正

### Python インターフェース

- 実際の分布に基づいて一意のデバイス特性を自動生成し、Camoufox に注入
- WebGL フィンガープリントの注入とローテーション
- ターゲット OS に基づいて正しいシステムフォント、サブピクセルアンチエイリアシング、ヒンティングを使用
- プロキシのターゲット地域から目標の地理位置情報、タイムゾーン、ロケールを計算してプロキシ検出を回避
- プロキシのターゲット地域における言語話者の分布に基づいてブラウザの言語を計算し偽装
- Playwright をサポートする他の言語で Camoufox を使用するためのリモートサーバーホスティング
- ヘッドレスサーバー上で Camoufox をヘッドフルに実行するための組み込み仮想ディスプレイバッファ
- 画像読み込み、WebRTC、WebGL の切り替え
- など

> [!NOTE]
> Camoufox は Chromium フィンガープリントの注入を完全にサポートしているわけではありません。一部の WAF（[Interstitial](https://nopecha.com/demo/cloudflare) など）は Spidermonkey エンジンの動作をテストするため、偽装は不可能です。

---

# ステルスの概要

## Camoufox が自動化ライブラリを隠す方法

> [!WARNING]
> **2026年現在の状況**:
> 個人的な事情により1年間メンテナンスが中断されていました。ベースの Firefox バージョンと新たに発見されたフィンガープリントの不整合により、Camoufox のパフォーマンスは低下しています。**Camoufox は現在活発に開発中です。**

Camoufox では、Playwright の内部 Page Agent のコードはすべてサンドボックス化され隔離されています。これにより、ページが JavaScript 検査を通じて Playwright の存在を検出することは不可能になります。

通常、Playwright は `window.__playwright__binding__` などの JavaScript をページに注入し、要素のクエリ、JavaScript の評価、init スクリプトの実行などのアクションを実行しますが、これらはウェブサイトによって検出される可能性があります。Camoufox では、これらのアクションはページの外部にある隔離されたスコープで処理されます。言い換えれば、ウェブサイトは Playwright が通常注入するであろう JavaScript を「見る」ことができなくなります。これにより、Playwright の痕跡を完全に排除できます。

しかし、自動化ライブラリを隠しても、Camoufox はフィンガープリントローテーションの不整合に対して免疫があるわけではありません。これには依然としてメンテナンスが必要であり、問題を発見して修正する必要があります。

### ページインタラクション

アンチボットシステムは、クライアント側のスクリプトを実行して動作を監視することもあります。例えば、マウスの動き、クリック、スクロール、アクション間のタイミングなどのパターンを調べます。

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

Camoufox は人間らしいマウス移動アルゴリズムで最善を尽くしています。この自然なモーションアルゴリズムは、元々 [riflosnake's HumanCursor](https://github.com/riflosnake/HumanCursor) のものであり、C++ で書き直され、より距離を意識した軌道に変更されています。

しかし、これは完璧ではありません。十分に洗練された分析があれば、依然として検出される可能性があります。（将来の課題）

---

## Camoufox がアイデンティティをローテーションする方法

AI エージェントは、多数のセッションにわたってフラグやレート制限を受けずに動作する必要があります。IP アドレスをローテーションするだけでは十分ではありません。ブラウザセッションごとに何千ものシグナルが送信され、固有の **フィンガープリント** が生成されます。ウェブサイトは OS、GPU、画面解像度、フォント、タイムゾーンなどを確認できます。これらのシグナルに一貫性がなかったり異常があったりすると、ブロックされます。

### 市場シェア分布

実行中の各ボットインスタンスに対して IP をローテーションしていても、Web アクセスファイアウォールは機械学習を使用して受信 Web トラフィックを分析し、異常かどうかを検出できます。Linux の市場シェアが 5% だったのに、突然 20% になれば、レッドフラグです。その場合、すべての Linux ユーザーにキャプチャの完了が無条件に要求されます。

Camoufox は [BrowserForge](https://github.com/daijro/browserforge) のフィンガープリントジェネレーターを使用して、実際のトラフィックにおけるデバイスデータの統計的分布を模倣します。例えば、Camoufox はブラウザを 5% の確率で Linux ユーザーのように見せかけます。その 5% のうち、9.5% の確率で 2560x1440 の画面解像度、27.5% の確率で Intel HD GPU を偽装します。

### Camoufox はどのように検出されるのか？

Camoufox は正しい市場シェアでフィンガープリントを偽装できます。しかし、**フィンガープリントは内部的にも一貫している必要があります。** Apple M1 GPU を搭載した Windows ユーザーエージェント、Windows DirectX レンダラーを搭載した MacOS ユーザーエージェント、デスクトップ画面解像度のモバイルデバイスはすべて不可能であり、不審としてフラグが立てられます。

信頼できる偽装フィンガープリントを作成するために変更する必要がある数千のデータポイントのうち、各変更が他の変更と一貫している必要がある場合、Camoufox は常に成功するとは限りません。アンチボットプロバイダーは、たった 1 つのユニークな不整合を見つけるために何度も Camoufox をテストし、見つかるとすぐにバックグラウンドスクリプトを更新してそれをテストします。

---

## Camoufox は他のソリューションと比べてどうですか？

### JavaScript ベースのソリューション

これまで、開発者は JavaScript を注入してこれらの値を偽装しようと試みてきましたが、JavaScript ですべてを偽装できるわけではないため、信頼性が低くなります。カバレッジが不完全だと、一貫性のないフィンガープリントが発生します。例えば、ネットワークリクエストの User Agent が navigator の 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 は Chromium の制御に CDP を使用しますが、Firefox には _Juggler_ を使用します。Juggler は Firefox が CDP をサポートする前に開発されたカスタムプロトコルです（[元のリポジトリ](https://github.com/puppeteer/juggler)）。これは Firefox 内の独立したモジュールであり、コアブラウザの一部ではありません。そのため、編集やページに何を公開するかの制御が容易です。

Camoufox は Juggler にパッチを適用し、ページの隔離された「コピー」を提供します。Playwright は独自のバージョンのページを自由に読み取り、編集できます。Playwright にとってはすべてが正常に動作しているように見えますが、実際のページはこれらの変更の影響をまったく受けません。また、ページは（getter の乗っ取りなどのトリックによって）読み取りが行われていることや、要素を監視するリスナーが追加されていることを検出できません。

さらに、Juggler は入力を Firefox のオリジナルのユーザー入力ハンドラーに直接送信するため、通常通りブラウザを使用している場合とまったく同じ方法で処理されます。Camoufox は Firefox のヘッドレスモードにもパッチを適用し、通常のウィンドウで実行されている場合と同じように見せかけます。ただし、フォールバックとして、ヘッドレスモードが漏洩した場合に備えて、Python ライブラリは [仮想ディスプレイ](https://camoufox.com/python/virtual-display/) 上で Camoufox を実行できます。

---

<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

次に、以下のコマンドでCamoufoxのソースコードをビルドします:```bash
make dir

> [!NOTE]
> 依存関係インストーラはこれまでmacOSでのみテストされています。

その後、Camoufoxをビルドできるようにシステムをブートストラップする必要があります。これは一度だけ行う必要があります。次のコマンドを実行して行います：```bash
make bootstrap

新しいビルドでは、`i686` は Windows でのみサポートされています。 サポートされていないターゲット/アーキテクチャの組み合わせはスキップされます。

<details>
<summary>
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. 対象のプラットフォームとアーキテクチャ向けにCamoufoxパッチをビルドする:```bash
docker run -v "$(pwd)/dist:/app/dist" camoufox-builder --target <os> --arch <arch>

パッチはここで編集、作成、削除、管理できます。

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

### パッチの作成方法

1. 開発者UIで、**Reset workspace** をクリックします。
2. 必要に応じて `camoufox-*/` フォルダ内で変更を行います。変更は `make build` と `make run` でテストできます。
3. 変更が完了したら、**Write workspace to patch** をクリックしてパッチファイルを保存します。

### 既存のパッチで作業する方法

1. 開発者UIで、**Edit a patch** をクリックします。
2. 編集したいパッチを選択します。ワークスペースは選択したパッチの状態にリセットされます。
3. 変更が完了したら、**Write workspace to patch** をクリックし、既存のパッチファイルを上書きします。

---

## リークデバッグ

これは、WAFのJavaScriptを難読化解除せずにリークを特定するためのプロセスを示すフローチャートです。この方法では、テストサイトがフラグを立てるまで、Camoufoxの機能をFirefoxのソースコードに段階的に再導入します。

このプロセスにはLinuxシステムが必要であり、Firefoxのビルドツールがインストールされていることを前提とします（[こちら](https://github.com/daijro/camoufox?tab=readme-ov-file#build-cli)を参照）。

<details>
<summary>
フローチャートを見る...
</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