HN 日本語サマリー

← 一覧へ戻る
セキュリティ

Show HN: TLSフィンガープリントを制御できるローカルMitMプロキシ

Show HN: A local MitM proxy to control TLS fingerprints (github.com)

9 pointsby ytkoka1 コメント

要約

impersonate-proxyは、YAML設定ファイルからTLSフィンガープリント(JA3/JA4)、HTTP/2フィンガープリント、HTTPヘッダー順序、User-Agent、ソースIPヘッダーを制御できるローカルのMITMプロキシです。Chrome拡張機能も含まれており、プロキシを再起動せずにブラウザツールバーから直接プロキシの切り替えやフィンガープリントプロファイルの変更が可能です。WAFボット検出システムの正規のセキュリティテストを目的としています。

全文翻訳

impersonate-proxy

[画像: Chrome Web Store]

English | 日本語 | 简体中文

単一のYAML設定ファイルから、TLSフィンガープリント(JA3/JA4)、HTTP/2フィンガープリント、HTTPヘッダー順序、User-Agent、ソースIPヘッダーをすべて制御できるローカルMITMプロキシ。

プロキシのトグルやフィンガープリントプロファイルの切り替えを、プロキシを再起動せずにブラウザツールバーから直接行えるChrome拡張機能が含まれています。

正規のセキュリティテストを目的としており、WAFのボット検出システムを対象とします。curl、ブラウザ、またはPlaywrightをプロキシ経由でルーティングし、さまざまなフィンガープリントの組み合わせがどのように分類されるかを観察できます。

仕組み

curl / browser / Playwright
        │  HTTP CONNECT (to proxy)
        ▼
┌─────────────────────────────────────────┐
│            impersonate-proxy            │
│                                         │
│  MITM TLS ◄──────────────► uTLS         │
│  (our CA cert)          (custom JA3/4)  │
│                                         │
│  Header rewriter (UA, order, add/del)   │
│  HTTP/2 framer  (SETTINGS, WINDOW_UPDATE│
│                  pseudo-header order)   │
└─────────────────────────────────────────┘
        │  Custom TLS ClientHello + HTTP/2
        ▼
   Target server / WAF
レイヤー制御可能な項目
TLS暗号スイート、拡張機能、その順序(JA3 / JA4)。uTLSプリセットまたは完全にカスタムなcustom_hello仕様を介して制御
HTTP/1.1ヘッダー順序、User-Agent、任意のヘッダーの追加/削除、IPスプーフィング(X-Forwarded-For / True-Client-IP)
HTTP/2SETTINGS値と順序、WINDOW_UPDATE、疑似ヘッダー順序(HTTP/2フィンガープリント)

前提条件

  • macOS または Linux (amd64 / arm64)
  • Go 1.22+
macOS
brew install go
Linux

ディストリビューションパッケージのGoはしばしば古い場合があります。公式バイナリを直接インストールしてください:

# ダウンロードと展開(最新版は https://go.dev/dl/ から 1.22.5 を置き換えてください)
curl -OL https://go.dev/dl/go1.22.5.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz

# PATHに追加(永続化するには、この行を ~/.bashrc または ~/.zshrc に追加してください)
export PATH=$PATH:/usr/local/go/bin

確認:

go version
# go version go1.22.5 linux/amd64

ARM64(Raspberry Pi、AWS Gravitonなど): ダウンロードURLの linux-amd64 を linux-arm64 に置き換えてください。

Docker(Goツールチェーンは不要)

Goをインストールする代わりに使い捨て環境を好む場合は、Docker に直接進んでください。

セットアップ

1. クローンとビルド
git clone https://github.com/ytkoka/impersonate-proxy.git
cd impersonate-proxy
make build
2. MITM CA証明書の生成

CAは初回実行時に自動生成されます。プロキシを一度起動して ca.crt と ca.key を作成してください:

make run
# 2026/04/22 12:00:00 generated CA certificate → ca.crt
# 2026/04/22 12:00:00 listening on 127.0.0.1:8080  preset=chrome

Ctrl-C で停止します。

3. CA証明書の信頼設定

クライアントは、プロキシ生成のリーフ証明書を拒否しないように、あなたのMITM CAを信頼する必要があります。

macOSシステムキーチェーン(すべてのアプリに影響):

make trust-ca        # 実行内容: sudo security add-trusted-cert ...

Linuxシステム信頼(すべてのアプリに影響;ca-certificatesパッケージが必要):

# Debian / Ubuntu
sudo cp ca.crt /usr/local/share/ca-certificates/impersonate-proxy.crt
sudo update-ca-certificates

# RHEL / Fedora / Amazon Linux
sudo cp ca.crt /etc/pki/ca-trust/source/anchors/impersonate-proxy.crt
sudo update-ca-trust

curlのみ(システム全体への変更なし):

curl --cacert ca.crt ...

Playwright / Node.js:

export NODE_EXTRA_CA_CERTS="$(pwd)/ca.crt"

Firefox:設定 → プライバシーとセキュリティ → 証明書を表示 → 認証局 → ca.crt をインポート

Docker

Go/Makeのローカルインストールなしで、コンテナ内でプロキシを実行します。

1. プロキシの起動

Linuxのみ: コンテナは特権のないユーザー(nonroot、UID 65532)として実行され、CA証明書/キーを保持する./dataディレクトリへの書き込みアクセスが必要です。./dataが存在しない場合、Dockerはそれをroot所有で他のユーザーには書き込み権限なしで自動作成するため、初回実行時にCAの生成に失敗します。事前に適切な所有者で作成してください:

mkdir -p data && sudo chown 65532:65532 data

Docker Desktop for Mac/Windowsでは不要です — バインドマウントレイヤーが所有権を自動的にマッピングします。

git clone https://github.com/ytkoka/impersonate-proxy.git
cd impersonate-proxy
docker compose up -d

これにより、イメージがローカルでビルドされ、コンテナが起動します。初回実行時にMITM CAが生成され、以下のように表示されます:

impersonate-proxy  | generated CA certificate → /data/ca.crt (add to OS trust store to avoid cert errors)
impersonate-proxy  | listening on 0.0.0.0:8080  preset=chrome

または、クローンせずにプリビルドイメージを直接実行するには:

docker run -d --name impersonate-proxy \
  -p 127.0.0.1:8080:8080 -p 127.0.0.1:8081:8081 \
  -v "$(pwd)/config.docker.yaml:/config.yaml:ro" \
  -v "$(pwd)/data:/data" \
  ghcr.io/ytkoka/impersonate-proxy:latest

docker-compose.ymlは両方のポートを127.0.0.1にのみ公開します — ネイティブインストールと同じループバックのみの公開です(管理APIには認証がないため、独自のアクセス制御を追加せずにこれを0.0.0.0に変更しないでください)。

2. CA証明書の信頼設定

CAはコンテナ内で生成されますが、バインドマウントされたボリュームを介してホストの./data/ca.crtおよび./data/ca.keyに永続化されるため、コンテナの再起動/再ビルド後も保持されます。ネイティブセットアップの上記とまったく同じように信頼設定を行いますが、./ca.crtの代わりに./data/ca.crtを指定します:

# curl
curl --proxy http://127.0.0.1:8080 --cacert ./data/ca.crt https://tls.peet.ws/api/all

# macOSシステムキーチェーン
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ./data/ca.crt
3. 設定

config.docker.yamlを編集し(ネイティブインストールのconfig.yamlではなく)、再起動してください:

docker compose restart

config.docker.yamlはconfig.yamlと同一ですが、listen/mgmt_listenが0.0.0.0(Dockerのポート公開がプロセスに到達するために必要 — コンテナ自体の127.0.0.1はホストから到達不能)であり、ca_cert/ca_keyが永続化されたボリュームである/dataを指している点が異なります。設定で利用可能なすべてのフィールドを参照してください。

Makefileショートカット
ターゲット説明
make docker-builddocker compose build を介してイメージをビルド
make docker-runビルドしてバックグラウンドで起動
make docker-stopコンテナを停止して削除

設定

プロキシを起動する前にconfig.yamlを編集してください。すべてのフィールドにはデフォルト値があります — オーバーライドしたいものだけを指定してください。

listen: "127.0.0.1:8080"
mgmt_listen: "127.0.0.1:8081"  # Chrome拡張機能が使用する管理API(無効にする場合は空にする)
ca_cert: "ca.crt"
ca_key:  "ca.key"

tls:
  # TLSフィンガープリントプリセット(JA3 / JA4を制御)
  # オプション: chrome | firefox | safari | edge | ios | random | golang
  preset: "chrome"

http:
  # User-Agentをオーバーライド(クライアントのUAをそのまま渡す場合は空にする)
  # "auto": tls.presetに一致するUAを使用(random/golang/customの場合はそのまま渡される)
  # "random": 内蔵リストからランダムなUAを選択
  user_agent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"

  # ソースIPをスプーフィング:X-Forwarded-ForとTrue-Client-IPの両方をこの値に設定し、
  # クライアントが既に設定した値を置き換えます(無効にする場合は空にする)
  # client_ip: "1.2.3.4"

  # この順序でヘッダーを発行;リストにないヘッダーは後に追加される
  header_order:
    - "Host"
    - "User-Agent"
    - "Accept"
    - "Accept-Language"
    - "Accept-Encoding"
    - "Connection"

  # ヘッダーの追加または上書き
  add_headers:
    Accept-Language: "ja,en-US;q=0.9,en;q=0.8"

  # フォワーディング前にヘッダーを削除
  remove_headers: []

http2:
  enabled: true

  # SETTINGSフレームのエントリ — IDと順序の両方がHTTP/2フィンガープリントに影響します。
  # RFC 7540 §11.3 ID:
  #   1=HEADER_TABLE_SIZE  2=ENABLE_PUSH  3=MAX_CONCURRENT_STREAMS
  #   4=INITIAL_WINDOW_SIZE  5=MAX_FRAME_SIZE  6=MAX_HEADER_LIST_SIZE
  settings:
    - { id: 1, val: 65536 }    # Chromeのデフォルト値が表示されています
    - { id: 2, val: 0 }
    - { id: 4, val: 6291456 }
    - { id: 6, val: 262144 }

  # コネクションレベルのWINDOW_UPDATEインクリメント
  window_update: 15663105

  # HEADERSフレーム内の疑似ヘッダーの順序
  pseudo_header_order: [method, authority, scheme, path]
管理API

プロキシが起動すると、mgmt_listen(デフォルトは127.0.0.1:8081)で軽量HTTP APIも公開されます。Chrome拡張機能はこれを使用して、プロキシを再起動せずに実行時に設定を読み書きします。curlで直接呼び出すこともできます:

エンドポイントメソッド説明
/api/configGET現在の設定をJSONで返します。現在のcustom_helloとアップストリームの状態も含まれます
/api/configPOSTTLSプリセット / custom_hello / クライアントIP / User-Agent / アップストリームの有効化+選択を部分的に更新します — 省略されたフィールドは変更されません
/api/upstreamGETアップストリームの状態を返します:enabled、select、設定されたプロキシの名前(URLや認証情報は決して返しません)、およびIPヘッダー抑制がアクティブかどうか

POST /api/configは真の部分更新です:変更したいフィールドのみを送信し、それ以外のすべて(TLSプリセットとアップストリーム選択を含む)はそのまま維持されます。

# 現在の設定を読み取る
curl http://127.0.0.1:8081/api/config

# Firefoxフィンガープリントに切り替え、スプーフィングされたIPを設定(他のフィールドは変更なし)
curl -s -X POST http://127.0.0.1:8081/api/config \
  -H "Content-Type: application/json" \
  -d '{"tls_preset":"firefox","client_ip":"203.0.113.1"}'

# 実行時に任意のJA3/JA4フィンガープリントに切り替える — config.yamlのcustom_helloブロックと同じフィールドをJSONとして送信(「カスタムTLSフィンガープリント」を参照)
curl -s -X POST http://127.0.0.1:8081/api/config \
  -H "Content-Type: application/json" \
  -d '{ 
    "tls_preset": "custom",
    "custom_hello": {
      "cipher_suites": [2570, 4865, 4866, 4867, 49195, 49199, 49196, 49200, 52393, 52392, 49171, 49172, 156, 157, 47, 53],
      "curves": ["X25519", "P256", "P384"],
      "versions": ["1.3", "1.2"],
      "extensions": [2570, 0, 23, 65281, 10, 11, 35, 16, 5, 18, 13, 51, 45, 43, 27, 21]
    },
    "client_ip": "",
    "user_agent": ""
  }'

# アップストリームプロキシを有効にし、名前で1つ選択 — TLSプリセット、
# クライアントIP、User-Agentはそのまま維持されます
curl -s -X POST http://127.0.0.1:8081/api/config \
  -H "Content-Type: application/json" \
  -d '{"upstream_enabled": true, "upstream_select": "residential_us"}'

# 現在のアップストリーム状態を読み取る
curl -s http://127.0.0.1:8081/api/upstream

変更は新しい接続に対して即座に有効になります。APIを完全に無効にするには mgmt_listen: "" を設定します。

ブラウザフィンガープリントリファレンス
ブラウザTLSプリセットHTTP/2 SETTINGSWINDOW_UPDATE
Chromechrome1:65536,2:0,4:6291456,6:26214415663105
Firefoxfirefox1:65536,4:131072,5:1638412517377
Safarisafari1:4096,3:100,4:2097152,6:1638410485760
User-Agent自動モード(user_agent: "auto")

user_agent: "auto"の場合、プロキシは現在のtls.presetに一致するUser-Agentを設定するため、TLSフィンガープリントとUAが矛盾することはありません。プリセットを切り替える(設定またはChrome拡張機能経由)と、UAも切り替わります。

tls.preset送信されるUser-Agent
chromeChrome 131 (macOS)
firefoxFirefox 132 (macOS)
safariSafari 17.2 (macOS)
edgeEdge 131 (Windows)
iosiPhone / iOS 17.1 Safari
random, golang, custom変更されない — クライアント自身のUAがそのまま渡される

"random"は、TLSプリセットに関係なく、リクエストごとに内蔵リストからランダムなUAを選択する別のモードです。

注意: edgeプリセットはchromeと同じTLS ClientHelloを送信し、iosプリセットはsafariと同じものを送信します(古いuTLS Edge 85 / iOS 14のhelloは、Edge 131およびiOS 17のUser-Agentと矛盾していました)。したがって、それらのJA3/JA4値はそれぞれChromeとSafariに一致します。

カスタムTLSフィンガープリント(preset: "custom")

組み込みプリセット(chrome、firefox、safariなど)は最も一般的なケースをカバーしています。特定のブラウザバージョンや、それらのプリセットとは異なるフィンガープリントに一致させる必要がある場合は、preset: "custom"を設定し、custom_helloブロックを提供してください。

JA3 / JA4と設定フィールドのマッピング

フィンガープリントコンポーネント設定フィールド注意点
TLSバージョン範囲versions最小/最大は自動的に導出される
暗号スイートリスト + 順序cipher_suites0x0a0aをGREASEプレースホルダーとして使用;uTLSが接続ごとにランダム化する
拡張機能タイプID + 順序extensions順序がJA3拡張機能コンポーネントを直接制御;GREASEパターン(0xXAXA)に一致する値は接続ごとにランダム化される
サポートされているグループ(曲線)curvesキー共有が送信されるものも制御する

JA3とJA4は一方向ハッシュです — ハッシュから仕様を逆算することはできません。対象ブラウザの基盤となるパラメータをtls.peet.wsまたはWiresharkで見つけ、それをcustom_helloに貼り付けてください。

Chrome 131の例

tls:
  preset: "custom"
  custom_hello:
    cipher_suites:      # 16進数ID;0x0a0a = GREASEプレースホルダー(接続ごとにランダム化)
      - 0x0a0a
      - 0x1301          # TLS_AES_128_GCM_SHA256
      - 0x1302          # TLS_AES_256_GCM_SHA384
      - 0x1303          # TLS_CHACHA20_POLY1305_SHA256
      - 0xc02b          # ECDHE-ECDSA-AES128-GCM-SHA256
      - 0xc02f          # ECDHE-RSA-AES128-GCM-SHA256
      - 0xc02c          # ECDHE-ECDSA-AES256-GCM-SHA384
      - 0xc030          # ECDHE-RSA-AES256-GCM-SHA384
      - 0xcca9          # ECDHE-ECDSA-CHACHA20-POLY1305
      - 0xcca8          # ECDHE-RSA-CHACHA20-POLY1305
      - 0xc013          # ECDHE-RSA-AES128-SHA
      - 0xc014          # ECDHE-RSA-AES256-SHA
      - 0x009c          # RSA-AES128-GCM-SHA256
      - 0x009d          # RSA-AES256-GCM-SHA384
      - 0x002f          # RSA-AES128-SHA
      - 0x0035          # RSA-AES256-SHA
    curves:             # X25519 | X25519Kyber768 | P256 | P384 | P521
      - "X25519Kyber768"
      - "X25519"
      - "P256"
    versions:           # アドバタイズするTLSバージョン
      - "1.3"
      - "1.2"
    extensions:         # 順序付けされた拡張機能タイプID(JA3拡張機能コンポーネントを制御)
      - 0x0a0a          # GREASE
      - 0               # server_name (SNI)
      - 23              # extended_master_secret
      - 65281           # renegotiation_info
      - 10              # supported_groups
      - 11              # ec_point_formats
      - 35              # session_ticket
      - 16              # ALPN
      - 5               # status_request
      - 18              # signed_certificate_timestamp
      - 13              # signature_algorithms
      - 51              # key_share
      - 45              # psk_key_exchange_modes
      - 43              # supported_versions
      - 27              # compress_certificate
      - 17513           # application_settings (ALPS)
      - 0x0a0a          # GREASE
      - 21              # padding

サポートされている拡張機能タイプID

ID名前注意点
0xXAXA (任意のGREASEパターン)GREASE接続ごとにランダム化される
0server_name (SNI)
5status_requestOCSPステープリング
10supported_groupscurvesリストを使用
11ec_point_formats固定:非圧縮(0)
13signature_algorithmsChrome風のデフォルト値
16ALPNh2, http/1.1をアドバタイズ
18signed_certificate_timestamp
21paddingBoringSSL風パディング
23extended_master_secret
27compress_certificate
28record_size_limit固定:0x4001
35session_ticket
43supported_versionsversionsリストを使用
45psk_key_exchange_modesPSKとDHE
50signature_algorithms_certChrome風のデフォルト値
51key_shareX25519およびP256(curvesから)のキー共有
17513application_settings (ALPS)h2をアドバタイズ
17613application_settings (ALPS, 新しいコードポイント)h2をアドバタイズ;Chrome 133+で17513の代わりに送信される
65037encrypted_client_hello (ECH)GREASE ECHペイロード(BoringSSL風)
65281renegotiation_info
その他GenericExtension空のペイロードで送信される

実行時更新: preset: "custom" はconfig.yamlに限定されません — 管理API(POST /api/configにcustom_helloオブジェクトを渡す、管理API参照)またはChrome拡張機能のTLSプリセットドロップダウンから、プロキシを再起動せずに実行時に切り替えることもできます。

アップストリームプロキシ

デフォルトでは、プロキシはターゲットに直接接続するため、X-Forwarded-For / True-Client-IPのスプーフィング(上記)はリクエストが「主張する」内容を変更するだけです — TCP接続の実際のソースIPは依然としてあなた自身です。upstream.enabled: trueを設定すると、ターゲット接続が最初にSOCKS5またはHTTP CONNECTプロキシを経由するようにルーティングされるため、実際の出口IPも変更されます。これにより、スプーフィング可能なヘッダーを無視して接続IP自体を見るWAFルールをテストしたり、「フィンガープリントは問題ないがIPが悪い」と「IPはクリーンだがフィンガープリントが間違っている」を分離したりできます。

トンネル可能なスキームのみがサポートされています — socks5、socks5h、およびhttp (CONNECT)。どちらもプロキシがuTLSでラップする生のTCPトンネルを返します。そのため、このツールが存在する理由であるClientHelloとHTTP/2フレーミングは完全に変更されずに通過します。https://(TLS終端)アップストリームはサポートされていません:それはTLS自体を復号化して再確立し、あなたのuTLSフィンガープリントを自身のものに置き換えてしまうからです。

upstream:
  enabled: false                         # デフォルトはオフ;再起動せずに実行時に切り替え可能
  select: "residential_us"               # プロキシ名 | "rotate" | "random" | ""(最初のプロキシ)
  dial_timeout_ms: 15000
  suppress_ip_headers_when_active: true  # アップストリームがアクティブな間はXFF/True-Client-IPをスキップ — クリーンなIPがスプーフィングされたIPを主張するのを避ける
  proxies:
    - name: residential_us
      url: "socks5://user:pass@gw.provider.com:1080"   # ホスト名はプロキシによって解決される(SOCKS5hの動作)、ローカルでは解決されない
    - name: datacenter
      url: "http://user:pass@dc.provider.com:8080"
    - name: tor
      url: "socks5://127.0.0.1:9050"                   # 無料で試せます:brew install tor && brew services start tor

TLSプリセットと同様の方法でプロキシを切り替えます — Chrome拡張機能の「Upstream proxy」トグル/ドロップダウン、または:

curl -s -X POST http://127.0.0.1:8081/api/config \
  -H "Content-Type: application/json" \
  -d '{"upstream_enabled": true, "upstream_select": "residential_us"}'

GET /api/upstreamとChrome拡張機能のドロップダウンは、常にプロキシの名前のみを表示します — URLと認証情報はプロキシプロセスから決して漏れません。

実際に機能したことを確認するには: アップストリームを有効にする前と後で実際の出口IPを確認し(例:curl --proxy http://127.0.0.1:8080 https://ifconfig.me)、tls.peet.wsでフィンガープリントが影響を受けていないことを別途確認してください — upstream.enabledがオンでもオフでも、JA3/JA4およびHTTP/2フィンガープリントは同一であるはずです。ネットワークパスのみが変更されたためです。

注意点: ブラウザ(curlとは異なり)は、オリジンごとに接続をプールして保持します。selectを切り替えたり(またはenabledをトグルしたり)してから、既に接続が開いているタブをリロードした場合、ブラウザはその既存の接続を再利用する可能性があり、変更が反映されるのは新しい接続が実際に確立されるまで待つ必要があります。新しいシークレットウィンドウでテストするか、chrome://net-internals/#socketsをフラッシュしてください。切り替えが効果がないように見える場合。

プロキシを接続を受け入れるからといって信頼しないでください。 SOCKS5/CONNECTハンドシェイクが成功したからといって、プロキシが正直かどうかはわかりません — 悪意のあるプロキシはTLS自体を終端し、生のバイトをトンネリングする代わりに独自の証明書を返すことができ、あなたがエンドツーエンドで暗号化されていると思っていたものをすべて読み取ったり(または変更したり)できます。自分で設定していないプロキシに依存する前に、まさにこの点を確認してください:それを介してhttps://tls.peet.wsにアクセスし、(a)証明書エラーがないこと、および(b)upstream.enabled: falseで取得するものとJA4が一致することを確認してください。証明書エラーまたは変更されたJA4は、「プロキシ」がトラフィックを傍受していることを意味し、トンネリングしていないことを意味します — それを介して何もルーティングしないでください。

Docker: ホストマシンを指すアップストリームURL(例:socks5://127.0.0.1:9050のローカルTorインスタンス)はコンテナ内では解決されません — そこでの127.0.0.1はホストのそれではなく、コンテナ自身のループバックです。代わりにsocks5://host.docker.internal:9050(Mac/WindowsのDocker Desktop)またはコンテナのデフォルトゲートウェイIP(Linux)を使用してください。

使用方法

プロキシの起動
make run
# ポート8080で実行中のインスタンスを停止し、再ビルドして起動します。

フィンガープリントプロファイルを切り替えるには、config.yamlを編集してmake runを再実行します。

curl
# CAがシステム全体で信頼されている場合(make trust-caの後):
curl --proxy http://127.0.0.1:8080 https://tls.peet.ws/api/all

# システム信頼がない場合 — CAを明示的に渡す:
curl --proxy http://127.0.0.1:8080 --cacert ca.crt https://tls.peet.ws/api/all
Chrome拡張機能

chrome-extension/ディレクトリには、ブラウザツールバーからプロキシを制御するManifest V3拡張機能が含まれています。

[画像: Chrome extension popup]

インストール:

オプションA — Chrome Web Store(推奨): [画像: Chrome Web Store]

オプションB — Unpackedとしてロード(開発用、または未リリース変更の試用):

  1. Chromeでchrome://extensionsを開きます
  2. デベロッパーモードを有効にします(右上隅のトグル)
  3. Load unpackedをクリックし、chrome-extension/フォルダを選択します

コントロール:

コントロール機能
Proxy toggleChromeのプロキシ設定を有効/無効にします(:8080経由でトラフィックをルーティング)
TLS PresetuTLSフィンガープリセットを切り替えます(chrome / firefox / safari / edge / ios / random / golang / custom)
Cipher Suites / Curves / TLS Versions / ExtensionsCustom (JA3/4) 選択時に表示 — YAMLを編集したりプロキシを再起動したりせずに、任意のJA3/JA4フィンガープリントをダイヤルできる config.yaml の custom_hello と同じフィールド
Client IP各リクエストに X-Forwarded-For および True-Client-IP を設定します
User-AgentHTTP User-Agent ヘッダーをオーバーライドします。Autoは選択されたTLSプリセットに従います(User-Agent自動モード参照);RandomはリクエストごとにランダムなUAを選択します。AutoとRandomは相互排他的です
Upstream proxyアップストリームSOCKS5/HTTP-CONNECTプロキシ経由のルーティングを有効にし、どのプロキシを選択するか(またはrotate/random)を設定します — Upstream proxyを参照
Apply button新しい設定を管理APIにPOSTします;即座に有効になります
API field管理APIのアドレス(デフォルト http://127.0.0.1:8081)

User-Agentのスコープ: 拡張機能はHTTP User-Agent ヘッダーのみを変更します。JavaScriptのnavigator.userAgentはブラウザ自体によって設定され、影響を受けません。両方を同時にスプーフィングするには、プロキシ設定と並行して--user-agent="..."でChromeを起動します。

Playwright (Node.js)
const { chromium } = require('playwright');

const browser = await chromium.launch();
const context = await browser.newContext({
  proxy: { server: 'http://127.0.0.1:8080' },
});
// CAがシステムキーチェーンにない場合、起動前に設定してください:
// NODE_EXTRA_CA_CERTS=./ca.crt node script.js
const page = await context.newPage();
await page.goto('https://tls.peet.ws/api/all');

より完全な例 — 管理APIを介してプリセットを循環させ、各プリセットに対するWAFの許可/ブロック判定を記録する — はexamples/waf-fingerprint-test.jsを参照してください。

Playwright (Python)
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    context = browser.new_context(proxy={"server": "http://127.0.0.1:8080"})
    page = context.new_page()
    page.goto("https://tls.peet.ws/api/all")

CAがシステム全体で信頼されていない場合は、NODE_EXTRA_CA_CERTS(Node)またはREQUESTS_CA_BUNDLE(Python)を設定してください。

フィンガープリントの検証

tls.peet.wsは、受信したすべてのリクエストの完全なフィンガープリントの内訳を返します。出力をjqまたはPythonにパイプして、読みやすい形式で表示します:

curl -s --proxy http://127.0.0.1:8080 --cacert ca.crt \
  https://tls.peet.ws/api/all | python3 -m json.tool

確認すべき主要なフィールド:

フィールド説明
tls.ja3_hashJA3フィンガープリントハッシュ
tls.ja4JA4フィンガープリント文字列
http2.akamai_fingerprintHTTP/2フィンガープリント文字列(SETTINGS + WINDOW_UPDATE + 疑似ヘッダー順序) — フィールド名はtls.peet.ws APIによって定義されています
http1.headersサーバーが受信した順序でのヘッダー名
user_agentサーバーから見たUser-Agent
ipサーバーから見たソースIP — ここでX-Forwarded-For / True-Client-IPのスプーフィングを確認

プロジェクト構造

impersonate-proxy/
├── main.go                   # エントリーポイント
├── config/config.go          # YAML設定構造体とデフォルト値
├── fp/dialer.go              # uTLSダイヤラ — TLSフィンガープリセット
├── h2fp/conn.go              # HTTP/2フレーマー — SETTINGS / WINDOW_UPDATE / 疑似ヘッダー制御
├── mitm/ca.go                # MITM CA:リーフ証明書の生成、キャッシュ、提供
├── upstream/                 # アップストリームSOCKS5/HTTP-CONNECTプロキシ:マネージャー、ダイヤラ、選択
├── proxy/proxy.go            # プロキシサーバー:CONNECT処理、プロトコル分岐、実行時設定
├── rewrite/headers.go        # HTTPヘッダー書き換え(UA、順序、追加/削除、IPスプーフィング)
├── mgmt/server.go            # 管理HTTP API(/api/config、/api/upstream)
├── chrome-extension/
│   ├── manifest.json         # Manifest V3
│   ├── popup.html            # ツールバーポップアップUI
│   ├── popup.css
│   ├── popup.js              # プロキシトグル + アップストリームトグル + 管理APIクライアント
│   ├── icon.svg
│   └── icon16.png, icon48.png, icon128.png  # ツールバー/Webストアアイコン
├── config.yaml               # デフォルト設定
├── config.docker.yaml        # docker-compose.ymlで使用される設定
├── examples/
│   └── waf-fingerprint-test.js  # Playwrightハーネス:プリセットを循環させ、WAFの判定を記録
├── Dockerfile
├── docker-compose.yml
└── Makefile

Makefileターゲット

ターゲット説明
make buildバイナリをコンパイル
make runビルドし、既存のインスタンスを停止して起動
make trust-camacOSシステムキーチェーンにca.crtを追加(sudoが必要)
make cleanバイナリ、ca.crt、ca.keyを削除
make docker-buildDockerイメージをビルド(Docker参照)
make docker-runコンテナをビルドしてバックグラウンドで起動
make docker-stopコンテナを停止して削除

クリーンアップ

バイナリと生成されたCAファイルを削除します:

make clean

CAをmacOSシステムキーチェーンに追加した場合、キーチェーンアクセス(「impersonate-proxy CA」で検索)を通じて削除するか、以下を実行します:

sudo security delete-certificate -c "impersonate-proxy CA" /Library/Keychains/System.keychain

制限事項

  • MITMのみ:プロキシはトラフィックを復号化および再暗号化します。クライアントは生成されたCAを信頼する必要があります。
  • クライアントからのHTTP/2なし:クライアント→プロキシの区間はHTTP/1.1(CONNECT経由)を使用します。プロキシ→サーバーの区間のみがカスタムフィンガープリントでHTTP/2を使用します。
  • チャンク化されたリクエストボディ:Transfer-Encoding: chunkedボディを持つリクエストは現在サポートされていません。
  • QUIC / HTTP/3なし:範囲外です。
  • User-Agent(HTTPヘッダーのみ):プロキシはUser-Agent HTTPヘッダーを書き換えますが、JavaScriptのnavigator.userAgentはブラウザによって独立して設定され、影響を受けません。両方を同時にオーバーライドするには、プロキシ設定と並行してChromeを--user-agent="..."フラグで起動します。
  • アップストリームプロキシはTCPトンネルのみ:socks5 / socks5h / http (CONNECT) アップストリームのみがサポートされています — TLS自体を終端するアップストリームは、uTLS ClientHelloを剥がしてしまうため、起動時に拒否されます。Upstream proxyを参照してください。

法的通知

このツールは、正規のセキュリティテストのみを目的としています — 例えば、あなたが所有しているシステム、またはテストする明確な書面による許可を得ているシステム上のWAFおよびボット検出設定のテストなどです。

このツールを不正にシステムに対して使用することは、適用される法律(コンピュータ不正アクセス禁止法、日本の不正アクセス行為の禁止等に関する法律、またはお住まいの管轄区域の同等の法律)および対象システムの利用規約に違反する可能性があります。

著者は不正使用に対するいかなる責任も負いません。

謝辞

  • uTLS — TLSフィンガープリントカスタマイズ
  • tls.peet.ws — 例で使用されるフィンガープリント検査API
  • JA4+ — フィンガープリント標準リファレンス

ライセンス

[画像: License: MIT]