🎭 Patchright

Patchright 是 Playwright 测试与自动化框架的一个经过修补且不易被检测的版本。
它可以作为 Playwright 的即插即用替代品。

[!NOTE]
本仓库提供 Patchright 驱动程序。要使用 Patchright，请查看 Python Package、NodeJS Package 或 社区驱动的 .Net Package。

[!IMPORTANT]
Patchright 仅修补基于 CHROMIUM 的浏览器。Firefox 和 Webkit 不受支持。

---

赞助商

^{想要赞助此项目？请在 Discord 上联系 @vinyzu！}

Swiftproxy：面向可扩展数据收集的高性能住宅代理

专为需要可靠、防检测代理基础设施的开发者打造。Swiftproxy 提供稳定的连接、高成功率和灵活的控制，适用于大规模爬取和自动化。

• 🌍 195+ 个地点，提供经过道德采购的住宅 IP
• 🔄 轮转 & 粘性会话，支持精确的地理定位
• ⚡ 针对防封禁 & 高成功率进行了优化
• 🔌 支持 HTTP / HTTPS / SOCKS5
• 🧪 免费 500MB 试用，供测试
• 💸 为 Patchright 用户提供特别折扣码：PROXY90 - 10% 折扣

^{最佳用途：网页爬取、自动化、多账号管理和大规模数据提取}

---

RapidProxy 提供稳定且高性能的代理网络，专为大规模数据操作而构建。

RapidProxy 提供：

• 🌍 9000 万+ 住宅 IP（200+ 个地点）
• 🔄 轮转住宅代理 — 从 $0.65/GB 起（流量永不过期）
• 🧩 静态住宅 IP — $5/IP（30 天，无限制流量）
• 🎯 精确的地理定位
• ⚡ 提供免费试用 — 无风险测试代理性能
• 专为爬取、自动化和高性能数据工作流而打造。
• 🔥 特别优惠：使用代码 RAPID10 享受 10% 折扣

^{快速启动，全球扩展，与 RapidProxy 保持稳定。}

---

NodeMaven：您值得信赖的代理提供商，提供优质 IP。
自动化、网页爬取、SEO 研究和社交媒体管理的绝佳解决方案。

为什么选择 NodeMaven？

✅ 99.9% 正常运行时间
🎯 粘性会话最长可达 7 天
🔍 IP 过滤：代理保证欺诈分数 < 97%
🔰 无需 KYC
💸 流量返现 - 消耗 GB 即可获得最高 10% 返现

面向 Patchright 用户的专属优惠码：
🔥 PATCHRIGHT35 - 移动和住宅代理享 35% 折扣
🔥 PATCHRIGHT40 - ISP（静态）代理享 40% 折扣

^{选择 NodeMaven 的质量与稳定。}

---

ColaProxy：低成本住宅代理，适用于可扩展的自动化、爬取和全球数据访问

为什么选择 ColaProxy？

• 动态住宅代理低至 $0.3/GB
• 覆盖 195+ 个国家的庞大住宅 IP 池
• 99.9% 正常运行时间，连接稳定快速
• 支持 HTTP / HTTPS / SOCKS5 协议
• 轮转和粘性会话，适用于灵活自动化
• 精确的国家级地理定位
• 7×24 小时专家支持

需要为 Patchright 自动化寻找可靠的代理？ColaProxy 提供高性价比的住宅、ISP 和移动代理解决方案，适用于爬取、测试、账户管理、SEO 监控和全球数据收集。使用优惠码 COLA20 享受订单 20% 折扣。

^{经济实惠、稳定可靠、专为开发者打造。立即使用 ColaProxy 开始扩展您的 Patchright 项目。}

---

补丁

Runtime.enable 泄露

这是 Patchright 所使用的最大补丁。为避免此泄露被检测，Patchright 通过在执行上下文（隔离的）中执行 JavaScript 来避免使用 Runtime.enable。

Console.enable 泄露

Patchright 通过完全禁用 Console API 来修补此泄露。这意味着控制台功能在 Patchright 中将无法使用。如果您确实需要控制台，使用 JavaScript 日志器可能更好——尽管它们也很容易被发现。

命令行标志泄露

Patchright 调整了 Playwright 默认参数以避免命令行标志泄露。这（最重要的）影响包括：

• --disable-blink-features=AutomationControlled（已添加）以避免 navigator.webdriver 检测。
• --enable-automation（已移除）以避免 navigator.webdriver 检测。
• --disable-popup-blocking（已移除）以避免弹窗崩溃。
• --disable-component-update（已移除）以避免被识别为隐身驱动。
• --disable-default-apps（已移除）以启用默认应用。
• --disable-extensions（已移除）以启用扩展

通用泄露

Patchright 修补了 Playwright 代码库中的一些通用泄露。这主要包括糟糕的配置和明显的检测点。

封闭影子根

Patchright 能够与封闭影子根中的元素进行交互。只需使用常规定位器，Patchright 会处理其余部分。
Patchright 现在也能在封闭影子根中使用 XPath。

---

隐身

在正确配置下，Patchright 目前被认为是不可检测的。 Patchright 通过了：

• Brotector ✅（配合 CDP-Patches）
• Cloudflare ✅
• Kasada ✅
• Akamai ✅
• Shape/F5 ✅
• Bet365 ✅
• Datadome ✅
• Fingerprint.com ✅
• CreepJS ✅
• Sannysoft ✅
• Incolumitas ✅
• IPHey ✅
• Browserscan ✅
• Pixelscan ✅

---

Bug

尽管我们花费了大量时间让 Patchright 尽可能稳定，但 Bug 仍可能发生。如果您遇到任何 Bug，请在 Issues 中报告。

Patchright 现在每次发布后都会针对 Playwright 测试进行测试。详情见 此处

[!WARNING]
Patchright 通过了大部分但并非所有 Playwright 测试。某些 Bug 被认为无法解决，某些则无关紧要。Bug 列表及说明见 此处。

基于 Playwright 测试，我们得出结论：在常规使用场景中你极不可能受到这些 Bug 的影响。

初始化脚本诡计

说明

为了在不使用 Runtime.enable 的情况下使用 InitScript，Patchright 使用 Playwright Routes 将 JavaScript 注入到 HTML 请求中。

Bug

Playwright Routes 可能在代码的其他部分引发一些 Bug。Patchright InitScript 不会引起任何普通 Playwright Routes 不会引起的 Bug。
如果您希望修复这些 Bug，则需要联系 Playwright 团队。

泄露

Patchright InitScript 可通过时间攻击被检测到。然而，目前没有反爬虫程序检查这类时间攻击，并且很可能在相当长一段时间内不会。
我们认为它们不会构成太大的检测风险。

---

TODO

• 实现在主执行上下文和隔离执行上下文之间选择的选项。
• 修复可修复的 Bug。
• 实现 .patch 更新器以方便显示 Patchright 的补丁。
• 在新版本发布时设置自动化测试。
• 在 .NET 上实现 Patchright。
• 在 Java 上实现 Patchright。

---

开发

新版本 Patchright 的部署是自动化的，但可能会因 Playwright 代码库变化而出现 Bug。这些 Bug 的修复可能需要几天才能发布。

---

支持我们的工作

如果您选择支持我们的工作，请通过 Discord 联系 @vinyzu 或 @steve_abcdef。

---

版权与许可

© Vinyzu

Patchright 采用 Apache 2.0 许可。

代码库的 某些部分 受 Driverless 启发。 感谢 Nick Webson 提供 .patch 文件文档化的思路。

---

免责声明

本仓库仅供 教育目的 使用。
不提供任何关于准确性、完整性或适用于任何目的的保证。使用风险自担——作者和维护者对因使用、修改或分发本代码而产生的 任何损害、法律问题 或 违反保证 不承担 任何责任。
任何滥用或违法行为均由用户自行承担。

---

作者

活跃维护者：Vinyzu
联合维护者：Kaliiiiiiiiii