规避技术

检测系统会跨层关联各种信号：网络 fingerprint（TCP/TLS/HTTP2）、浏览器 fingerprint（canvas、WebGL、navigator）以及行为（鼠标、键盘、时序）。通过了一层却在另一层失败，仍然会让你被标记。一个住宅 IP 却带着不匹配的 TCP fingerprint，或者一个完美的浏览器 fingerprint 却配上机器人式的点击，都会被任何做交叉比对的系统抓住。本页讲的是 Pydoll 免费提供给你的部分，以及你能掌控、用来保持各层一致的杠杆。

你免费获得的部分

因为 Pydoll 通过 CDP 驱动真实的 Chrome，而不是凭空构造请求，所以有几层无需任何配置就是真实的：

真实的网络 fingerprint。 Chrome 的 TCP/IP 栈、TLS（BoringSSL）和 HTTP/2 栈会产生真正的 fingerprint：TLS ClientHello、HTTP/2 SETTINGS 帧、伪首部顺序和流优先级都与真实的 Chrome 一致。而以编程方式构造请求的工具（requests、httpx、curl）做不到这一点。
真实的浏览器 fingerprint。 Canvas、WebGL 和 AudioContext 都来自真实的 GPU 和音频硬件。Navigator 属性、内置的 PDF 插件和 MIME 类型都反映了真实的浏览器状态。
navigator.webdriver 为 false。 Selenium、Playwright 和 Puppeteer 会把它设为 true。Pydoll 启动时不带自动化标志，所以它报告 false，和普通会话一样。你无需修补它。
完整的输入事件序列。 通过 CDP 派发的输入会生成完整的事件链（pointermove、pointerdown、mousedown、pointerup、mouseup、click），与真实用户完全一样。

本页接下来讲的是你确实能掌控的那些层。

保持 User-Agent 一致

最常见的自动化破绽是一个自相矛盾的 User-Agent：HTTP User-Agent 首部说的是一回事，而 navigator.userAgent、navigator.platform 和 Client Hints（Sec-CH-UA、Sec-CH-UA-Platform）说的又是另一回事。把 --user-agent= 作为普通的 Chrome 标志来设置，只会改变 HTTP 首部，而不会改动 JavaScript 和 Client Hints，这种不匹配会被检测器立刻读出来。

Pydoll 会帮你修正这一点。当它检测到 --user-agent= 参数时，会用匹配的 platform 和完整的 Client Hints 元数据来应用 Emulation.setUserAgentOverride，并注入 navigator.vendor / navigator.appVersion，使每一层都保持一致，新标签页也不例外。

import asyncio

from pydoll.browser.chromium import Chrome
from pydoll.browser.options import ChromiumOptions


async def main():
    options = ChromiumOptions()
    options.add_argument(
        '--user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) '
        'AppleWebKit/537.36 (KHTML, like Gecko) '
        'Chrome/130.0.0.0 Safari/537.36'
    )

    async with Chrome(options=options) as browser:
        tab = await browser.start()
        await tab.go_to('https://browserleaks.com/javascript')

asyncio.run(main())

让字符串中的 Chrome/<version> 与你实际运行的 Chrome 保持一致；一个你并未运行的版本本身就是一种不匹配。这个覆盖会应用于第一个标签页、通过 browser.new_tab() 创建的标签页，以及通过 browser.get_opened_tabs() 获取的标签页。

让语言、时区和地理位置与 IP 匹配

在 proxy 之后，浏览器的语言、时区和位置应当与该 IP 所在的国家一致。一个位于东京的 IP，却带着 Accept-Language: en-US 和 America/New_York 时区，就是自相矛盾的。

语言是一个独立的选项：

options = ChromiumOptions()
options.add_argument('--lang=ja-JP')
options.set_accept_languages('ja-JP,ja;q=0.9,en;q=0.8')

这会同时设置 Accept-Language 首部和 navigator.language / navigator.languages。时区和地理位置也必须匹配，而且它们需要同时与 User-Agent 所声明的操作系统以及 IP 保持一致。从单个 profile 出发连贯地设置这些，正是 apply_fingerprint() 的用途；参见 Fingerprint 注入。

阻止 WebRTC 泄露你的 IP

WebRTC 即便在 proxy 之后也可能泄露真实 IP，因为 STUN 请求会绕过 proxy 隧道。每当你为了 stealth 而使用 proxy 时，都应打开内置的保护：

options = ChromiumOptions()
options.webrtc_leak_protection = True   # --force-webrtc-ip-handling-policy=disable_non_proxied_udp

表现得像真人

瞬间点击和完全规律的按键是一种行为 fingerprint。传入 humanize=True，就能让光标沿一条曲线、以拟人的节奏移动，并以变化的节奏打字，偶尔出现被纠正的拼写错误：

field = await tab.find(id='search')
await field.type_text('browser automation', humanize=True)
await field.click(humanize=True)

关于时序模型以及如何调整它，参见拟人化交互。

看起来像一个用过的 profile

一个全新的、没有任何历史记录、所有功能都被禁用的 profile，和真实用户的 profile 毫不相像。通过 browser_preferences 预先填充这个 profile（陈旧的时间戳、匹配的 Chrome 版本、已启用的功能），具体见浏览器偏好设置。

常见错误

把一切都随机化。 随机的 hardwareConcurrency、deviceMemory 和屏幕尺寸会拼凑出不可能存在的设备。真实的机器是受约束的：4 核配 8 GB 内存和 1920x1080 的屏幕是合理的；17 核配 0.5 GB 内存和 4K 屏幕则不然。请使用从真实浏览器采集的 profile，而不是随机值。

注入 canvas 噪声。 给 canvas 输出添加噪声会适得其反：检测器会反复采样 fingerprint，而一个在多次读取之间发生变化的值，本身就是一个自动化信号。Pydoll 的 canvas 是真实且稳定的；别去动它。

过时的 User-Agent。 一个来自六个月前 Chrome 版本的 UA，会缺少当前版本才有的功能和 Client Hints。请保持在最近两三个主要版本以内，并与你运行的二进制文件相匹配。

忽视会话行为。 即便有一个干净的 fingerprint，一分钟内加载 100 个页面、从不滚动、从不空闲，也都是异常。请加入阅读延迟、变化节奏，并包含自然的停顿。

验证你的配置

在大规模运行之前，用以下这些工具检查你的 fingerprint：

工具	URL	测试内容
BrowserLeaks	`https://browserleaks.com/`	Canvas、WebGL、字体、IP、WebRTC、HTTP/2
CreepJS	`https://abrahamjuliot.github.io/creepjs/`	谎言检测、一致性检查
Pixelscan	`https://pixelscan.net/`	机器人检测分析
IPLeak	`https://ipleak.net/`	WebRTC、DNS、IP 泄露

用 Pydoll 做一个快速自检：

result = await tab.execute_script('''
    return {
        userAgent: navigator.userAgent,
        webdriver: navigator.webdriver,
        languages: navigator.languages,
        plugins: navigator.plugins.length,
        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
    };
''')
fp = result['result']['result']['value']

assert fp['webdriver'] is False, 'navigator.webdriver should be false'
assert 'HeadlessChrome' not in fp['userAgent'], 'headless leaking in the UA'

下一步

Fingerprint 注入：从单个 profile 应用一套连贯的身份（User-Agent、WebGL、时区、locale）。
拟人化交互：深入讲解行为层。
Proxy：更改并验证你的出口 IP。
指纹识别（深入）：这些杠杆背后的检测原理。