Proxy MCP

代理mcp

proxy-mcp是一个运行显式HTTP/HTTPS MITM代理（L7）的mcp服务器。它捕获请求/响应，允许您在运行中修改流量（标头/正文/模拟/转发/丢弃），支持上游代理链接，并记录与代理（JA3/JA4）以及可选上游服务器JA3S的连接的TLS指纹。通过代理发送“拦截器”来路由隐形浏览器（斗篷浏览器、源代码修补的Chromium）、CLI工具、Docker容器和Android设备/应用程序，以及Playwright驱动的浏览器自动化，包括基于定位器的点击、打字、滚动和ARIA快照。

目录

• 设置
• HTTP代理配置
• 界限
• TLS客户端Hello直通
• 与CDP/剧作家搭档
• 移动捕获（透明代理）
• 工具参考

- 生命周期 - 上游代理 - 拦截规则 - 流量捕获 - 修改快捷方式 - TLS指纹识别 - 拦截器 - 浏览器工具等效工具 - 会话 - 人性化工具

• 资源
• 使用示例
• 建筑
• 测试
• 学分

设置

快速安装（克劳德代码）

claude mcp add proxy-mcp -- npx -y proxy-mcp@latest

这将使用stdio传输将代理mcp安装为mcp服务器。每次克劳德代码重启时，它都会自动更新。

范围：

# Per-user (available in all projects)
claude mcp add --scope user proxy-mcp -- npx -y proxy-mcp@latest

# Per-project (shared via .mcp.json, commit to repo)
claude mcp add --scope project proxy-mcp -- npx -y proxy-mcp@latest

先决条件

• Node.js 22+

来源（开发）

git clone https://github.com/yfe404/proxy-mcp.git
cd proxy-mcp
npm install
npm run build

# stdio transport (default) — used by MCP clients like Claude Code
node dist/index.js

# Streamable HTTP transport — exposes /mcp endpoint for scripting
node dist/index.js --transport http --port 3001

--transport 和 --port 也接受env变量 TRANSPORT 和 PORT.

手动MCP配置

克劳德代码CLI：

# stdio (default)
claude mcp add proxy-mcp -- npx -y proxy-mcp@latest

# From local clone
claude mcp add proxy-mcp -- node /path/to/proxy-mcp/dist/index.js

# HTTP transport for scripting
claude mcp add --transport http proxy-mcp http://127.0.0.1:3001/mcp

.mcp.json （项目级，承诺回购）：

{
  "mcpServers": {
    "proxy": {
      "command": "npx",
      "args": ["-y", "proxy-mcp@latest"]
    }
  }
}

可流式HTTP传输：

{
  "mcpServers": {
    "proxy": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:3001/mcp"
    }
  }
}

HTTP代理配置

1） 启动代理并获取端点

proxy_start

使用返回的 port 和终点 http://127.0.0.1: .

2） 浏览器设置（推荐：拦截器）

使用浏览器拦截器，以便自动配置代理标志和证书信任。发射 三叶草 --默认情况下，带有源代码级C++指纹补丁和人性化模式的隐形修补Chromium：

interceptor_browser_launch --url "https://example.com"

使用Playwright支持的工具（无CDP，无sidecar）驱动页面-- target_id 这就是你所需要的）：

interceptor_browser_navigate --target_id "browser_" --url "https://apify.com"
interceptor_browser_snapshot  --target_id "browser_"
interceptor_browser_screenshot --target_id "browser_" --file_path "/tmp/shot.png"

3） 浏览器设置（手动回退）

如果手动启动浏览器，请亲自传递代理标志：

google-chrome --proxy-server="http://127.0.0.1:
"

4） CLI/进程设置

通过设置代理环境变量，通过代理mcp路由任何进程：

export HTTP_PROXY="http://127.0.0.1:
"
export HTTPS_PROXY="http://127.0.0.1:
"
export NO_PROXY="localhost,127.0.0.1"

如果客户端验证TLS，则信任代理mcp CA证书（请参阅 proxy_get_ca_cert)或使用终端拦截器(interceptor_spawn)它设置了代理环境变量和常见的CA环境变量（curl、Node、Python请求、Git、npm/yarn等）：

interceptor_spawn --command curl --args '["-s","https://example.com"]'

明确的 curl 示例：

curl --proxy http://127.0.0.1:
 http://example.com
curl --proxy http://127.0.0.1:
 https://example.com

5） 上游代理链

设置从代理mcp到另一个上游代理的可选代理链接（用于地理位置、身份验证或IP信誉）：

Client/app  →  proxy-mcp (local explicit proxy)  →  upstream proxy (optional chaining layer)

proxy_set_upstream --proxy_url "socks5://user:pass@upstream.example:1080"

支持的上游URL方案： socks4://, socks5://, http://, https://, pac+http://.

典型的地理布线示例：

# Route ALL outgoing traffic from proxy-mcp via a geo proxy
proxy_set_upstream --proxy_url "socks5://user:pass@fr-exit.example.net:1080"

# Bypass upstream for local/internal hosts
proxy_set_upstream --proxy_url "http://user:pass@proxy.example.net:8080" --no_proxy '["localhost","127.0.0.1",".corp.local"]'

# Route only one hostname via a dedicated upstream (overrides global)
proxy_set_host_upstream --hostname "api.example.com" --proxy_url "https://user:pass@us-exit.example.net:443"

# Remove overrides when done
proxy_remove_host_upstream --hostname "api.example.com"
proxy_clear_upstream

对于HTTPS MITM，在目标环境中必须信任代理CA(proxy_get_ca_cert).

6） 快速验证和排除故障

proxy_list_traffic --limit 20
proxy_search_traffic --query "example.com"

常见问题：

• 来自错误浏览器实例的流量（修复：始终通过 target_id 从 interceptor_browser_launch)
• 目标上缺少HTTPS证书信任
• NO_PROXY 绕过预期主机
• 首次启动很慢：斗篷浏览器在首次使用时下载约200 MB的隐形Chromium二进制文件（之后缓存）

7) HAR 导入 + 重播

将HAR导入持久会话，然后使用现有的会话查询/发现工具进行分析：

proxy_import_har --har_file "/path/to/capture.har" --session_name "imported-run"
proxy_list_sessions
proxy_query_session --session_id SESSION_ID --hostname_contains "api.example.com"
proxy_get_session_handshakes --session_id SESSION_ID

重播默认为模拟运行（仅预览）。执行需要显式模式：

# Preview what would be replayed
proxy_replay_session --session_id SESSION_ID --mode dry_run --limit 20

# Execute replay against original hosts
proxy_replay_session --session_id SESSION_ID --mode execute --limit 20

# Optional: override target host/base URL while preserving path+query
proxy_replay_session --session_id SESSION_ID --mode execute --target_base_url "http://127.0.0.1:8081"

注意：导入的HAR条目（以及由创建的条目） proxy_replay_session)不携带JA3/JA4/JA3S握手元数据。使用实时代理捕获的流量来分析握手指纹。

移动捕获（透明代理）

对于具有忽略系统代理的自定义HTTP堆栈的移动应用程序（大多数现代Android应用程序——Shopee、SHEIN、TikTok、银行等），显式代理不会看到它们的流量。代理mcp发货 透明听众 它位于使用TLS SNI的iptables REDIRECT和MITM后面——不需要CONNECT隧道。

配对 代理ap卡 --一个广播WiFi AP的XIAO ESP32-S3(proxy-ap SSID默认），并作为USB-PCM以太网适配器呈现给笔记本电脑。该回购处理AP+NAPT端；代理mcp处理笔记本电脑端。

先决条件

• 笔记本电脑：Linux iptables, sysctl, nmcli （网络管理器）， ip （iproute2）， adb. sudo 用于网络配置（每个会话一个命令）。
• 硬件路由器一 代理ap卡 （XIAO ESP32-S3），固件已闪存。或者任何USB以太网/USB WiFi组合，其中笔记本电脑NAT手机子网的流量——通过 --ap_iface / --ap_subnet 以覆盖默认值。
• 目标设备：安卓系统 根 （Magisk/KernelSU）。需要Root将CA注入系统证书存储。Android 14-16还需要此工具自动执行的合子挂载命名空间注入。
• ADB访问权限：目标设备必须出现在 adb devices （至少USB，配对后无线）。

首次演练

1.Flash+插入代理ap卡

跟随 代理ap卡README 构建+刷新XIAO。重新插入时，笔记本电脑应显示 cdc_ncm 接口（验证： ls /sys/class/net/*/device/uevent | xargs grep DRIVER | grep cdc_ncm).

2.通过USB将目标设备连接到笔记本电脑

每个设备只需要第一次推送CA。请用验证 adb devices。复制序列号。

3.运行安装工具

proxy_mobile_setup --android_serial 

可选参数：

响应是JSON，有三个关键位：

{
  "ap_iface": "enp195s0f3u1u4",
  "cert_injected": true,
  "android_target_id": "adb_HQ63C81CB2",
  "sudo_command": "sudo bash /tmp/proxy-mcp-mobile-setup-.sh"
}

保持 android_target_id 周围——拆卸时你需要它。

4.运行发出的sudo脚本

sudo bash /tmp/proxy-mcp-mobile-setup-.sh

这是唯一需要的sudo。该脚本是幂等的，可以安全地重新运行。它探测路线 iptables 需要root：

# Static IP on the AP iface (skipped if already configured).
ip addr add 192.168.99.2/24 dev 

# Forwarding + dedicated nat chain.
sysctl -w net.ipv4.ip_forward=1
iptables -t nat -N PROXY_MCP_PREROUTING
iptables -t nat -A PROXY_MCP_PREROUTING -p tcp --dport 80  -j REDIRECT --to-ports 8080
iptables -t nat -A PROXY_MCP_PREROUTING -p tcp --dport 443 -j REDIRECT --to-ports 8443
iptables -t nat -A PREROUTING -i  -j PROXY_MCP_PREROUTING

# Block QUIC so apps fall back to TCP/TLS.
iptables -A FORWARD -i  -p udp --dport 443 -j DROP

# Masquerade out through the real egress.
iptables -t nat -A POSTROUTING -s 192.168.4.0/24 -o  -j MASQUERADE

为什么是脚本而不是直接执行？MCP以您的用户身份运行；iptables需要root； sudo 来自MCP工具的请求将需要NOPASSWD或polkit策略（脆弱的、特定于发行版的）。发出脚本是可审计的、可复制的和可移植的。

5.将手机连接到 proxy-ap 无线网络

凭据在代理ap卡固件中设置（默认SSID proxy-ap，该存储库中显示的默认密码）。连接后，手机可以从USB拔下——未来的会话不需要它。

6.开始捕捉

现在，来自手机的每个HTTP/HTTPS请求都会进入代理mcp的环形缓冲区：

proxy_list_traffic --source_filter transparent   # iptables-redirected HTTPS
proxy_list_traffic --source_filter explicit      # absolute-URL HTTP that arrived on :80
proxy_get_exchange --exchange_id             # full headers + body preview
proxy_search_traffic --query "api.example.com"   # full-text search

每个条目都携带 source: "explicit" | "transparent" +TLS指纹(ja3, ja4).

后续会话（手机已配对）

跳过步骤2。运行：

proxy_mobile_setup                                # skip android_serial — cert already installed
sudo bash /tmp/proxy-mcp-mobile-setup-.sh

然后手机加入AP并捕获简历。

上游链

集 upstream_proxy_url 通过住宅/ISP代理路由出站流量——目标服务器看到的是该代理的IP，而不是您的笔记本电脑的IP：

proxy_mobile_setup \
  --upstream_proxy_url "http://user:pass@proxy.example.com:8000" \
  --android_serial 

适用于两位听众。使用 proxy_set_upstream 事后更改它而不重新启动。

验证每个步骤

拆除

proxy_mobile_teardown --android_target_id 
sudo bash /tmp/proxy-mcp-mobile-teardown-.sh

MCP调用会停止两个侦听器并停用Android目标。sudo脚本删除iptables规则，禁用 ip_forward，并将AP接口交还给NetworkManager。手机会一直连接到AP，直到您在手机WiFi设置中忘记它。

故障排除

没有代理ap卡

手机可以通过的任何USB-PCM或USB以太网桥都可以工作：

proxy_mobile_setup --ap_iface eth1 --ap_address 10.0.0.1/24 --ap_subnet 10.0.0.0/24

或者通过以下方式使用笔记本电脑托管的WiFi AP hostapd 在USB WiFi适配器（MT76x2U、RTL8812AU等）上——通过 wlanN 接口as ap_iface.

局限性

• 证书固定 --即使安装了CA信任，锁定特定公钥的应用程序（Instagram、WhatsApp、银行、Shopee主页提要等）也会拒绝我们的mocktp证书。您可以看到部分捕获（跟踪/静态/取消固定端点成功，固定API调用失败）。修复：Frida或LSPosed为该特定应用程序取消绑定模块。看 interceptor_frida_attach 在工具参考中，或 morrownr的USB WiFi指南 对于常见的模式。
• Android上的Chrome浏览器 --Chrome发布了自己的Mozilla CA捆绑包，并强制执行证书透明度。我们的CA是自签名的，不在任何CT日志中，因此Chrome会拒绝它，而不管系统信任度如何。使用任何其他应用程序（或任何基于OkHttp/Conscrypt的浏览器）来验证管道。
• QUIC/HTTP3 --透明侦听器仅是TCP/TLS。默认情况下，我们丢弃UDP/443，这样应用程序就会回退到TCP。集 block_quic: false 如果你 *想要* QUIC通过未捕获（QUIC内容不会出现在流量日志中）。
• 非标准端口 --默认的iptables规则仅重定向TCP/80和TCP/443。Shopee的 :20346，自定义游戏协议等将绕过。在sudo脚本（或链）中添加更多REDIRECT规则 redsocks 通过显式监听器发出CONNECT隧道）。
• 本机TLS固定 --一些应用程序直接通过JNI使用BoringSLSL/OpenSSL，引脚嵌入在 .soJava层Frida钩子无法捕获这些；需要原生钩子。
• 需要根 --系统信任CA覆盖需要root。非root Android只信任用户安装的CA，这些CA用于通过明确选择加入的应用程序 network_security_config --这是没有航运应用程序可以做到的。没有根就没有旁路。

界限

• 只看到交通 配置为通过它进行路由 （不是网络窃听器或数据包嗅探器）
• 滑稽模仿 出站JA3+HTTP/2指纹+头顺序 （通过impit——原生Rust TLS模拟），而不是JA4（JA4仅用于捕获）
• 可以添加、覆盖或删除HTTP标头；输出标头 顺序 可以通过指纹欺骗进行控制
• 返回自己的CA证书-- 不 公开上游服务器证书链

TLS ClientHello Passthrough（通过拦截器访问浏览器）

当斗篷浏览器通过以下方式启动时 interceptor_browser_launch，代理mcp转发浏览器的 原始TLS客户端Hello 向上游服务器发送文档加载和同源子资源请求。目标服务器看到的是真实的Chrome TLS指纹，而不是代理的指纹。

这是与典型的MITM代理（mitmproxy、Charles、Fiddler）的一个关键区别，后者使用自己的指纹重新终止TLS，使反机器人系统通过JA3/JA4分析可以轻松检测到MITM。

如何验证passthrough是否正常工作：

proxy_list_tls_fingerprints --hostname_filter "example.com"

• JA3各不相同 跨请求访问同一主机——这是意料之中的；Chrome随机化每个连接的密码套件顺序（Chrome 110+以来的功能）
• JA4保持稳定 --相同的密码/扩展集，只是顺序不同
• JA3变体+JA4稳定性=确认真实的Chrome TLS透传

当passthrough应用时与需要欺骗时：

基于斗篷浏览器+剧作家

浏览器自动化使用 三叶草 --带有源代码级C++指纹补丁的隐形修补Chromium——由Playwright驱动。没有CDP表面，没有sidecar，没有手动滚动的隐形脚本。一 target_id 从 interceptor_browser_launch 是下游工具所需的一切。

标准流量：

1. 呼叫 proxy_start
2. 可选地为跨源子资源启用出站指纹欺骗： proxy_set_fingerprint_spoof --preset chrome_136
3. 呼叫 interceptor_browser_launch --url "https://example.com"
4. 驱动页面： interceptor_browser_navigate, interceptor_browser_snapshot, humanizer_click --selector "...", humanizer_type --text "..."
5. 检查交通： proxy_search_traffic --query ""

工具参考

生命周期（4）

透明/移动捕捉（6）

上游代理（4）

拦截规则（7）

快速调试示例：

# Simulate a request and see which rule would win
proxy_test_rule_match --mode simulate --request '{"method":"GET","url":"https://example.com/api/v1/items","headers":{"accept":"application/json"}}'

# Evaluate a real captured exchange by ID
proxy_test_rule_match --mode exchange --exchange_id "ex_abc123"

流量捕捉（4）

修改快捷方式（3）

TLS指纹识别（9）

指纹欺骗的工作原理是通过impit从代理重新发出请求（通过rustls进行本机Rust TLS/HTTP2模拟）。TLS 1.3和HTTP/2指纹（设置、WINDOW_UPDATE、优先级帧）通过构造与真实浏览器匹配。源服务器看到代理的伪造TLS、HTTP/2和标头顺序，而不是原始客户端的 user_agent 如果已设置（包括通过预设），代理mcp还会规范Chromium UA客户端提示标头(sec-ch-ua*)以匹配被欺骗的用户代理（转发相互矛盾的提示是一种常见的机器人信号）。 浏览器异常： 当斗篷浏览器通过以下方式启动时 interceptor_browser_launch，文档加载和同源请求使用浏览器的原生TLS（无impit），为机器人检测挑战保留指纹一致性。只有跨源子资源请求才会使用伪造的TLS重新发出。非浏览器客户端（curl、spawn、HAR重放）在所有请求上都会获得完整的TLS+UA欺骗。使用 proxy_set_fingerprint_spoof 浏览器预设为一个命令设置。 proxy_set_ja3_spoof 为了向后兼容而保留，但忽略了自定义JA3字符串（而是使用预设的impit浏览器目标）。捕获JA4指纹（只读），但不支持欺骗。

拦截器（21）

拦截器配置目标（浏览器、进程、设备、容器）以自动通过代理路由其流量。

探索（3）

浏览器（3）

隐形是源代码级别：斗篷浏览器提供48个C++补丁，因此ja3n/ja4/akamai与真正的Chrome相匹配， navigator.webdriver 如果为false，则音频/画布/WebGL指纹与真实硬件匹配。不需要JS隐形注射。首次启动会下载约200 MB的Chromium二进制文件（之后缓存）。

迷彩（4）——反检测火狐

Camoufox是一款带有源代码级指纹控件（操作系统、WebGL供应商/渲染器、字体、区域设置、地理IP派生时区、WebRTC阻止、人性化光标）的修补版Firefox。与Chromium路径不同，camofox作为一个外部Python进程运行，并公开了一个Playwright WS端点——调用者使用以下命令驱动页面 await firefox.connect(wsUrl) 而不是通过MCP页面工具。

主机要求：

pip install "camoufox[geoip]"
python3 -m camoufox fetch          # downloads patched Firefox binary (~200 MB)

# For TLS MITM trust (NSS profile is created per-launch and the proxy CA is imported):
sudo apt install libnss3-tools     # Debian/Ubuntu
sudo dnf install nss-tools         # Fedora/RHEL
# macOS: brew install nss   (or use /Applications/Firefox.app/Contents/MacOS/certutil)

如果 certutil 如果缺少，启动仍然成功，但代理CA不受信任——HTTPS页面将显示证书错误。代理流量仍被捕获。

用途：

proxy_start                                     // start the MITM proxy
interceptor_camoufox_launch { headless: true }  // returns { targetId, wsUrl, playwright_connect, ... }
// in your own Node code:
//   import { firefox } from 'playwright-core';
//   const browser = await firefox.connect(wsUrl);
//   const page = await (await browser.newContext()).newPage();
//   await page.goto('https://example.com');
interceptor_camoufox_close { target_id }        // when done

playwright-core 已经是代理mcp依赖项——Camoufox使用其 firefox 通过WebSocket访问命名空间；不需要额外的Node包。流量捕获、TLS指纹识别、规则、模拟、会话、上游链和JA3/JA4欺骗都会自动应用于camofox，因为代理位于其前面。

终端/工艺（2）

设置18个以上的env变量，涵盖curl、Node.js、Python请求、Deno、Git、npm/yarn。

安卓ADB（4）

注意事项： CA证书注入需要root访问权限。支持安卓14+(/apex/com.android.conscrypt/cacerts/).Wi-Fi代理是可选的（默认关闭）。

安卓Frida（3）

注意事项： 需要 frida-server 在设备上运行。用途 frida-js （纯JS，主机上没有本机二进制文件）。SSL取消绑定包括OkHttp、BoringSSL、TrustManager、系统TLS，但可能不适用于QUIC或自定义TLS堆栈。

Docker（2）

两种模式： exec （实时注射，现有流程需要重新启动）和 restart （停止+重新启动容器）。用途 host.docker.internal 用于代理URL。

浏览器开发工具等效工具（12）

浏览器目标的剧作家驱动工具。每个都需要一个 target_id directly——没有会话绑定，没有sidecar。适用于两种斗篷浏览器(browser_* ID）和迷彩服(camoufox_* ID）目标通过共享 getPageForTarget() 解析器。

网络数据来自MITM代理，而不是浏览器端协议——无论浏览器报告什么，代理都会看到每个有线请求。

JS注入的隐形权衡：

参考文献 剧作家评价, 剧作家addInitScript, 迷彩主要世界eval, 迷彩隐形.

世界和孤立——你的JS能看到什么，不能看到什么

这两个后端提供不同的世界模型。选择错误的工具是迷彩上最常见的隐形脚枪，因此边界很重要。

Cloakbrowser（Chromium）。 剧作家 evaluate 在一个孤立的“公用事业”世界中运行 *与页面的主世界共享全局*一 addInitScript 补丁到 navigator.webdriver 对（a）您的后续用户可见 evaluate 探测和（b）网站加载的反机器人代码。这是大多数“隐形剧本”所假设的模型。检测向量位于CDP侧(Runtime.evaluate chatter）——clokebrowser的C++补丁缓解了这些问题。48个源代码补丁清除了JS可观察到的泄漏(__playwright__binding__，堆栈跟踪 sourceURL 提示）。

迷彩服（Firefox通过Juggler）。 两个严格分离的JS堆：

• 主要世界 --页面是真实的 window.站点脚本、反机器人指纹代码和通过注入的标签 addScriptTag 跑这里。
• 孤立/杂耍世界 --剧作家的私人视野。不同 window 对象，相同的DOM。 evaluate （无 mw:)以及 addInitScript 两者均在此着陆。

后果：a addInitScript 那确实 Object.defineProperty(navigator, 'webdriver', { get: () => false }) 补丁 *孤立的* navigator.你的后续 evaluate 探头读取 *相同* 隔离作用域，查看修补后的值，并返回 false.测试通过。 但该网站的检测代码在主世界中运行，并读取未修补的 navigator. 补丁是看不见的。这正是 迷彩服#48.

这不是迷彩服的虫子；这是设计。迷彩伪装指纹 C++二进制 （在启动时通过配置 os, fonts, webgl_config, humanize等），所以主世界JS看到了欺骗的值 *就好像它们是真的一样*Chromium时代“通过运行时补丁”的剧本 addInitScript“这就是迷彩所取代的。

实用规则：

伪装的强大隐形推论：反机器人代码在主世界运行 简直无法观察 你的 evaluate 阅读。不 Function.toString 泄漏，页面脚本中没有堆栈帧，没有影子全局变量。这是一个不同的世界。同样的隔离使 addInitScript “失败”使刮擦变得不可观察。

会议（13）

持久、可查询的磁盘上捕获，用于长时间运行和崩溃后分析。

proxy_get_session_exchange 和 proxy_export_har 根据存储的数据自动解压缩响应体（gzip、deflate、brotli） content-encoding 头球回归 responseBodyText 和 responseBodyBase64 包含解压缩的内容。原始压缩字节保留在磁盘上，以获得精确的重放保真度。

注意 proxy_start 随着 persistence_enabled: true：此自动创建会话。A后续 proxy_session_start() 调用返回现有的活动会话，而不是失败——不需要停止并重新启动。

人性化——剧作家输入（5）

通过Playwright进行类人浏览器输入 page.mouse / page.keyboard，叠加在斗篷浏览器内置的人性化模式之上。绑定到 target_id 从 interceptor_browser_launch.

所有工具都需要 target_id 从先前 interceptor_browser_launch。该引擎在调用过程中保持跟踪鼠标位置，因此 humanizer_move 紧随其后 humanizer_click 产生连续的路径。

行为细节：

• 鼠标路径：具有随机控制点的三次贝塞尔曲线，Fitts定律距离/大小缩放，可选过冲+校正弧
• 打字：WPM的基本延迟，由二元组频率修改（像“th”这样的常见对更快），移位键惩罚，单词边界暂停。可选的拼写错误注入使用带退格校正的QWERTY邻居图
• 滚动：根据easeInOutQuad速度曲线，在多个车轮事件中分布的总增量
• 闲置：周期性微抖动（±3px微妙/±8px正常）和可配置强度的随机微滚动

资源

使用示例

# Start the proxy
proxy_start

# Optional: start persistent session recording
proxy_session_start --capture_profile full --session_name "reverse-run-1"

# Configure device to use proxy (Wi-Fi settings or interceptors)
# Install CA cert on device (proxy_get_ca_cert)

# Or use interceptors to auto-configure targets:
interceptor_browser_launch                    # Launch stealth browser with proxy
interceptor_spawn --command curl --args '["https://example.com"]'  # Spawn proxied process
interceptor_android_activate --serial DEVICE_SERIAL               # Android device

# Set upstream proxy for geolocation
proxy_set_upstream --proxy_url socks5://user:pass@geo-proxy:1080

# Mock an API response
proxy_mock_response --url_pattern "/api/v1/config" --status 200 --body '{"feature": true}'

# Inject auth headers (set value to null to delete a header)
proxy_inject_headers --hostname "api.example.com" --headers '{"Authorization": "Bearer token123"}'

# View captured traffic
proxy_list_traffic --hostname_filter "api.example.com"
proxy_search_traffic --query "error"

# TLS fingerprinting
proxy_list_tls_fingerprints                # See unique JA3/JA4 fingerprints
proxy_set_ja3_spoof --ja3 "771,4865-..."   # Spoof outgoing JA3 (for non-browser clients)
proxy_set_fingerprint_spoof --preset chrome_136 --host_patterns '["example.com"]'  # Full fingerprint spoof
proxy_list_fingerprint_presets                  # Available browser presets

# Human-like browser interaction (requires interceptor_browser_launch target)
humanizer_move   --target_id "browser_" --x 500 --y 300
humanizer_click  --target_id "browser_" --selector "#login-button"
humanizer_click  --target_id "browser_" --role "button" --name "Sign in"
humanizer_type   --target_id "browser_" --text "user@example.com" --wpm 45
humanizer_scroll --target_id "browser_" --delta_y 300
humanizer_idle   --target_id "browser_" --duration_ms 2000 --intensity subtle

# Run / inject JS in the page (cloakbrowser + camoufox)
interceptor_browser_evaluate           --target_id "browser_" --script_path /tmp/probe.js
interceptor_browser_evaluate           --target_id "camoufox_" --script_path /tmp/probe.js --world main   # camoufox + main_world_eval=true
interceptor_browser_inject_init_script --target_id "browser_" --script_path /tmp/hook.js   # applies on next navigation
interceptor_browser_add_script_tag     --target_id "browser_" --script_path /tmp/lib.js    # DOM-visible — avoid for stealth

# Query/export recorded session
proxy_list_sessions
proxy_query_session --session_id SESSION_ID --hostname_contains "api.example.com"
proxy_export_har --session_id SESSION_ID

建筑

• 国家: ProxyManager singleton管理mocktp服务器、规则和流量
• 规则重建：必须在mocktttp之前设置规则 start()，因此规则更改会触发停止/重新创建/重新启动循环
• 流量捕获: on('request') + on('response') 按请求ID关联的事件
• 环形缓冲区：最多1000个条目，正文预览上限为4KB
• TLS捕获：来自mocktttp套接字元数据的客户端JA3/JA4；服务器JA3S通过 tls.connect 猴子补丁
• TLS欺骗：impit（通过rustls进行原生Rust TLS/HTTP2模拟）；正在处理中，不需要容器
• 拦截器：由管理 InterceptorManager，每种类型独立注册
• 浏览器：通过Playwright驱动的斗篷浏览器（隐形Chromium，首次启动时自动下载约200 MB二进制文件） BrowserContext / Page
• 人性化工具：使用Playwright的Singleton引擎 page.mouse / page.keyboard自定义定时层（贝塞尔路径、费茨定律、二元组输入）为Playwright提供数据，位于斗篷浏览器内置的顶部 humanize: true

测试

npm test              # All tests (unit + integration)
npm run test:unit     # Unit tests only
npm run test:integration  # Integration tests
npm run test:e2e      # E2E fingerprint tests (requires cloakbrowser + internet)

学分

核心库

供应商Frida脚本

中的所有脚本 src/frida-scripts/vendor/ 源自 httptoolkit/frida拦截和解包 （MIT）：

• config-template.js --代理/证书配置注入
• android-certificate-unpinning.js --TrustManager+OkHttp+BoringSSL挂钩
• android-system-certificate-injection.js --通过KeyStore注入运行时证书
• android-proxy-override.js --ProxySelector猴子补丁
• native-tls-hook.js --BoringSLSL/OpenSSL原生挂钩
• native-connect-hook.js --libc connect() 重定向