Show HN: TLSフィンガープリントを制御できるローカルMitMプロキシ
Show HN: A local MitM proxy to control TLS fingerprints (github.com)
要約
impersonate-proxyは、YAML設定ファイルからTLSフィンガープリント(JA3/JA4)、HTTP/2フィンガープリント、HTTPヘッダー順序、User-Agent、ソースIPヘッダーを制御できるローカルのMITMプロキシです。Chrome拡張機能も含まれており、プロキシを再起動せずにブラウザツールバーから直接プロキシの切り替えやフィンガープリントプロファイルの変更が可能です。WAFボット検出システムの正規のセキュリティテストを目的としています。
全文翻訳
impersonate-proxy
単一の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/2 | SETTINGS値と順序、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 dataDocker 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-build | docker 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/config | GET | 現在の設定をJSONで返します。現在のcustom_helloとアップストリームの状態も含まれます |
/api/config | POST | TLSプリセット / custom_hello / クライアントIP / User-Agent / アップストリームの有効化+選択を部分的に更新します — 省略されたフィールドは変更されません |
/api/upstream | GET | アップストリームの状態を返します: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 SETTINGS | WINDOW_UPDATE |
|---|---|---|---|
| Chrome | chrome | 1:65536,2:0,4:6291456,6:262144 | 15663105 |
| Firefox | firefox | 1:65536,4:131072,5:16384 | 12517377 |
| Safari | safari | 1:4096,3:100,4:2097152,6:16384 | 10485760 |
User-Agent自動モード(user_agent: "auto")
user_agent: "auto"の場合、プロキシは現在のtls.presetに一致するUser-Agentを設定するため、TLSフィンガープリントとUAが矛盾することはありません。プリセットを切り替える(設定またはChrome拡張機能経由)と、UAも切り替わります。
tls.preset | 送信されるUser-Agent |
|---|---|
chrome | Chrome 131 (macOS) |
firefox | Firefox 132 (macOS) |
safari | Safari 17.2 (macOS) |
edge | Edge 131 (Windows) |
ios | iPhone / 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_suites | 0x0a0aを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 | 接続ごとにランダム化される |
0 | server_name (SNI) | |
5 | status_request | OCSPステープリング |
10 | supported_groups | curvesリストを使用 |
11 | ec_point_formats | 固定:非圧縮(0) |
13 | signature_algorithms | Chrome風のデフォルト値 |
16 | ALPN | h2, http/1.1をアドバタイズ |
18 | signed_certificate_timestamp | |
21 | padding | BoringSSL風パディング |
23 | extended_master_secret | |
27 | compress_certificate | |
28 | record_size_limit | 固定:0x4001 |
35 | session_ticket | |
43 | supported_versions | versionsリストを使用 |
45 | psk_key_exchange_modes | PSKとDHE |
50 | signature_algorithms_cert | Chrome風のデフォルト値 |
51 | key_share | X25519およびP256(curvesから)のキー共有 |
17513 | application_settings (ALPS) | h2をアドバタイズ |
17613 | application_settings (ALPS, 新しいコードポイント) | h2をアドバタイズ;Chrome 133+で17513の代わりに送信される |
65037 | encrypted_client_hello (ECH) | GREASE ECHペイロード(BoringSSL風) |
65281 | renegotiation_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拡張機能が含まれています。
インストール:
オプションA — Chrome Web Store(推奨): [画像: Chrome Web Store]
オプションB — Unpackedとしてロード(開発用、または未リリース変更の試用):
- Chromeで
chrome://extensionsを開きます - デベロッパーモードを有効にします(右上隅のトグル)
- Load unpackedをクリックし、
chrome-extension/フォルダを選択します
コントロール:
| コントロール | 機能 |
|---|---|
| Proxy toggle | Chromeのプロキシ設定を有効/無効にします(:8080経由でトラフィックをルーティング) |
| TLS Preset | uTLSフィンガープリセットを切り替えます(chrome / firefox / safari / edge / ios / random / golang / custom) |
| Cipher Suites / Curves / TLS Versions / Extensions | Custom (JA3/4) 選択時に表示 — YAMLを編集したりプロキシを再起動したりせずに、任意のJA3/JA4フィンガープリントをダイヤルできる config.yaml の custom_hello と同じフィールド |
| Client IP | 各リクエストに X-Forwarded-For および True-Client-IP を設定します |
| User-Agent | HTTP 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_hash | JA3フィンガープリントハッシュ |
tls.ja4 | JA4フィンガープリント文字列 |
http2.akamai_fingerprint | HTTP/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-ca | macOSシステムキーチェーンにca.crtを追加(sudoが必要) |
make clean | バイナリ、ca.crt、ca.keyを削除 |
make docker-build | Dockerイメージをビルド(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-AgentHTTPヘッダーを書き換えますが、JavaScriptのnavigator.userAgentはブラウザによって独立して設定され、影響を受けません。両方を同時にオーバーライドするには、プロキシ設定と並行してChromeを--user-agent="..."フラグで起動します。 - アップストリームプロキシはTCPトンネルのみ:
socks5/socks5h/http(CONNECT) アップストリームのみがサポートされています — TLS自体を終端するアップストリームは、uTLS ClientHelloを剥がしてしまうため、起動時に拒否されます。Upstream proxyを参照してください。
法的通知
このツールは、正規のセキュリティテストのみを目的としています — 例えば、あなたが所有しているシステム、またはテストする明確な書面による許可を得ているシステム上のWAFおよびボット検出設定のテストなどです。
このツールを不正にシステムに対して使用することは、適用される法律(コンピュータ不正アクセス禁止法、日本の不正アクセス行為の禁止等に関する法律、またはお住まいの管轄区域の同等の法律)および対象システムの利用規約に違反する可能性があります。
著者は不正使用に対するいかなる責任も負いません。
謝辞
- uTLS — TLSフィンガープリントカスタマイズ
- tls.peet.ws — 例で使用されるフィンガープリント検査API
- JA4+ — フィンガープリント標準リファレンス