自定义浏览器指纹：控制网站读取的信号

npm install puppeteer-core

export SCRAPELESS_API_KEY="your_api_token_here"

import puppeteer from 'puppeteer-core';

const fingerprint = {
  userAgent:
    'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36',
  platform: 'Windows',
  screen: { width: 1280, height: 1024 },
  localization: { languages: ['en-US', 'en'], timezone: 'Asia/Hong_Kong' },
  args: { '--window-size': '1280,1024' },
};

const params = new URLSearchParams({
  token: process.env.SCRAPELESS_API_KEY,
  sessionTTL: '180',
  proxyCountry: 'ANY',
  fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
});

const browser = await puppeteer.connect({
  browserWSEndpoint: `wss://browser.scrapeless.com/api/v2/browser?${params}`,
});
const page = await browser.newPage();
await page.goto('https://example.com', { waitUntil: 'domcontentloaded' });
await browser.close();

const reported = await page.evaluate(() => ({
  userAgent: navigator.userAgent,
  platform: navigator.platform,

在实际运行中，所有四个值都返回作为指纹的值——用户代理逐字，平台为Win32（来自平台：'Windows'），解析的时区为Asia/Hong_Kong，语言为en-US。覆盖将在页面实际读取的JavaScript环境中生效，而不仅仅是在请求头中。

> 在免费计划中获取您的API密钥：[app.scrapeless.com](https://app.scrapeless.com/passport/login/?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint)

---

## 使信号一致

指纹只有在其组成部分讲述一个故事时才有帮助。会导致会话被标记的常见不匹配：

- **时区与IP** — 在美国出口后面有香港时区被视为不一致。将`proxyCountry`设置为与时区和语言匹配的区域，或将时区设置为与出口匹配。时区处理遵循由<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/resolvedOptions" rel="nofollow"><strong>Intl.DateTimeFormat API</strong></a>引用的IANA区域。
- **平台与用户代理** — 一个`Windows`平台与macOS用户代理字符串是矛盾的。保持平台字段与用户代理的操作系统标记一致；用户代理语法在<a href="https://datatracker.ietf.org/doc/html/rfc9110#name-user-agent" rel="nofollow"><strong>HTTP语义规范</strong></a>中定义。
- **语言与区域** — 按照该地区用户的方式排列`languages`，将主要语言放在首位。
- **屏幕与窗口** — 保持`screen`尺寸和`--window-size`参数对您正在模拟的设备来说合理。

这些信号正是<a href="https://owasp.org/www-project-automated-threats-to-web-applications/" rel="nofollow"><strong>OWASP自动威胁项目</strong></a>中编纂的自动客户端信号——它们之间的一致性是真实浏览器所具备而不小心的机器人所不具备的。

---

## 高级模式

**在会话之间旋转指纹，而不是在内部。** 在会话生命周期内保持指纹稳定，以便在访问过程中不会改变故事；而是在会话之间进行变化。

**将出口固定在指纹的区域。** 设置`proxyCountry`（在需要时设置`proxyState`/`proxyCity`）以匹配您选择的时区和语言。

**通过配置文件持久化身份。** 当您需要在多个运行中使用相同身份时，将指纹与浏览器配置文件配对，以便cookie和存储可以继续使用。

**保持合理。** 一个没有真实设备会产生的指纹与一个默认的指纹一样可疑——使用描述实际存在的浏览器的值。

---

## 结论：一个一致的身份

自定义指纹并不是单一的技巧——它是在报告一个一致身份的浏览器和一个自相矛盾的浏览器之间的区别。将用户代理、平台、屏幕、时区和语言一起设置，固定位出口以匹配，网站读取的值与真实浏览器的一致。将其与[抓取浏览器](https://www.scrapeless.com/zh/product/scraping-browser?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint)的会话控制和居民出口配对，了解[为什么IP声誉很重要](https://www.scrapeless.com/zh/blog/what-is-a-cloud-proxy?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint)，[文档](https://docs.scrapeless.com)涵盖每个字段。

---

## 准备构建您的AI驱动数据管道了吗？

加入我们的社区以获取免费计划，并与正在构建反检测工作流的开发者联系：[Discord](https://discord.gg/VU2vtbq7Q2) · [Telegram](https://t.me/scrapeless)。

在[app.scrapeless.com](https://app.scrapeless.com/passport/login/?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint)注册以获取免费的抓取浏览器运行时，并查看[定价](https://www.scrapeless.com/zh/pricing?utm_source=website&utm_medium=blog&utm_campaign=scrapingbrowser&utm_term=custom-browser-fingerprint)以便于扩展。

---

## 常见问题

**问：什么是浏览器指纹？**
网站读取以识别您的浏览器的一组信号——用户代理、平台、屏幕大小、时区、语言，以及更深入的值，如canvas和WebGL。网站将它们组合成一个标识符，并标记那些看起来不像真实设备的组合。

**问：设置指纹真的会改变页面看到的内容吗？**
是的。在实时运行中，`navigator.userAgent`、`navigator.platform`、解析后的时区和`navigator.language`都返回了会话中设置的值——覆盖达到了JavaScript环境，而不仅仅是请求头。

**问：时区应该与代理国家匹配吗？**
是的，时区与出口IP区域相矛盾是一个常见的标志。将`proxyCountry`设置为与指纹的时区和语言匹配，或将时区设置为与出口IP一致。

**问：我可以轮换指纹吗？**
在会话之间轮换，而不是在一个会话内。会话中途更改的指纹本身就是一个信号；保持每个会话的稳定性，并在会话之间进行变化。

**问：我需要一个AI代理或SDK吗？**
不需要。指纹是标准Puppeteer WebSocket端点上的查询参数——只需简单的`puppeteer.connect()`，不需要代理。