🎭 Patchright

Patchright는 Playwright 테스트 및 자동화 프레임워크의 패치된, 탐지되지 않는(undetected) 버전입니다.
Playwright의 드롭인 대체품으로 사용할 수 있습니다.

[!NOTE]
이 저장소는 Patchright 드라이버를 제공합니다. Patchright를 사용하려면 Python 패키지, NodeJS 패키지 또는 커뮤니티 기반 .Net 패키지를 확인하세요.

[!IMPORTANT]
Patchright는 CHROMIUM 기반 브라우저만 패치합니다. Firefox와 Webkit은 지원되지 않습니다.

---

스폰서

^{이 프로젝트를 후원하고 싶으신가요? Discord에서 @vinyzu에게 연락하세요!}

Swiftproxy: 확장 가능한 데이터 수집을 위한 고성능 리버시(Residential) 프록시

안정적이고 탐지 방지 기능을 갖춘 프록시 인프라가 필요한 개발자를 위해 제작되었습니다. Swiftproxy는 안정적인 연결, 높은 성공률, 그리고 대규모 스크래핑 및 자동화를 위한 유연한 제어 기능을 제공합니다.

• 🌍 윤리적으로 확보된 리버시 IP를 갖춘 195개 이상의 지역
• 🔄 정밀한 지역 타게팅이 가능한 회전(Rotating) 및 고정(Sticky) 세션
• ⚡ 차단 방지(anti-ban) 및 높은 성공률에 최적화
• 🔌 HTTP / HTTPS / SOCKS5 지원
• 🧪 테스트용 무료 500MB 체험
• 💸 Patchright 사용자를 위한 특별 할인 코드: PROXY90 - 10%

^{가장 적합한 용도: 웹 스크래핑, 자동화, 멀티 계정 관리, 대규모 데이터 추출}

---

는 대규모 데이터 작업을 위해 설계된 안정적이고 고성능의 프록시 네트워크를 제공합니다.

---

패치(Patches)

Runtime.enable 누출(Leak)

이는 Patchright가 사용하는 가장 중요한 패치입니다. 이 누출로 인한 탐지를 피하기 위해 Patchright는 Runtime.enable 사용을 피하고 (격리된) ExecutionContext에서 JavaScript를 실행합니다.

Console.enable 누출

Patchright는 Console API를 완전히 비활성화하여 이 누출을 패치합니다. 즉, Patchright에서는 콘솔 기능이 작동하지 않습니다. 콘솔이 정말로 필요하다면 JavaScript 로거를 사용하는 것이 나을 수 있지만, 이 역시 쉽게 탐지될 수 있습니다.

명령 플래그 누출(Command Flags Leaks)

Patchright는 명령 플래그 누출에 의한 탐지를 피하기 위해 Playwright 기본 인자(Default Args)를 조정합니다. 이는 (가장 중요하게) 다음에 영향을 줍니다:

• --disable-blink-features=AutomationControlled (추가됨) navigator.webdriver 탐지를 피하기 위함.
• --enable-automation (제거됨) navigator.webdriver 탐지를 피하기 위함.
• --disable-popup-blocking (제거됨) 팝업 충돌을 피하기 위함.
• --disable-component-update (제거됨) 스텔스 드라이버로 탐지되는 것을 피하기 위함.
• --disable-default-apps (제거됨) 기본 앱을 활성화하기 위함.
• --disable-extensions (제거됨) 확장 프로그램을 활성화하기 위함.

일반 누출(General Leaks)

Patchright는 Playwright 코드베이스의 몇 가지 일반적인 누출을 패치합니다. 주로 잘못된 설정과 명백한 탐지 지점이 포함됩니다.

폐쇄형 섀도우 루트(Closed Shadow Roots)

Patchright는 폐쇄형 섀도우 루트(Closed Shadow Roots)의 요소와 상호작용할 수 있습니다. 일반 로케이터를 사용하기만 하면 나머지는 Patchright가 처리합니다.
Patchright는 이제 폐쇄형 섀도우 루트에서 XPath도 사용할 수 있습니다.

---

스텔스(Stealth)

올바른 설정을 갖추면 Patchright는 현재 탐지 불가능한 것으로 간주됩니다. Patchright는 다음을 통과합니다:

• Brotector ✅ (CDP-Patches 포함)
• Cloudflare ✅
• Kasada ✅
• Akamai ✅
• Shape/F5 ✅
• Bet365 ✅
• Datadome ✅
• Fingerprint.com ✅
• CreepJS ✅
• Sannysoft ✅
• Incolumitas ✅
• IPHey ✅
• Browserscan ✅
• Pixelscan ✅

---

버그(Bugs)

Patchright를 최대한 안정적으로 만들기 위해 많은 시간을 투자했지만, 버그는 여전히 발생할 수 있습니다. 버그를 발견하면 Issues에 보고해 주세요.

Patchright는 이제 모든 릴리스 후 Playwright 테스트와 대조하여 테스트됩니다. 여기에서 확인하세요.

[!WARNING]
Patchright는 대부분의 Playwright 테스트를 통과하지만 전부는 아닙니다. 일부 버그는 해결이 불가능한 것으로 간주되며, 일부는 관련이 없을 뿐입니다. 버그 목록과 설명은 여기에서 확인하세요.

Playwright 테스트를 기반으로, 일반적인 사용 사례에서 이러한 버그의 영향을 받을 가능성은 매우 낮다고 결론지었습니다.

InitScript 꼼수(Init Script Shenanigans)

설명

Runtime.enable 없이 InitScript를 사용할 수 있도록, Patchright는 Playwright Routes를 사용하여 HTML 요청에 JavaScript를 주입합니다.

버그

Playwright Routes는 코드의 다른 부분에서 일부 버그를 유발할 수 있습니다. Patchright InitScript는 일반 Playwright Routes가 유발하지 않을 버그를 유발하지 않습니다.
이러한 버그를 수정하려면 Playwright 팀에 문의해야 합니다.

누출

Patchright InitScript는 타이밍 공격(Timing Attacks)으로 탐지될 수 있습니다. 그러나 현재 어떤 안티봇도 이러한 종류의 타이밍 공격을 확인하지 않으며, 앞으로 한동안 확인하지 않을 가능성이 높습니다.
우리는 이를 큰 탐지 위험으로 간주하지 않습니다.

---

TODO

• 실행 컨텍스트(메인/격리) 선택 옵션 구현.
• 수정 가능한 버그 수정.
• Patchright의 패치를 쉽게 보여주는 .patch 업데이터 구현.
• 새 릴리스에 자동화된 테스트 설정.
• .NET에 Patchright 구현.
• Java에 Patchright 구현.

---

개발(Development)

새로운 Patchright 버전의 배포는 자동으로 이루어지지만, Playwright 코드베이스 변경으로 인한 버그가 발생할 수 있습니다. 이러한 버그에 대한 수정은 릴리스되는 데 며칠이 걸릴 수 있습니다.

---

작업 지원(Support our work)

저희 작업을 지원하기로 결정하셨다면 Discord에서 @vinyzu 또는 @steve_abcdef에게 연락해 주세요.

---

저작권 및 라이선스(Copyright and License)

© Vinyzu

Patchright는 Apache 2.0 라이선스입니다.

코드베이스의 일부 부분은 Driverless에서 영감을 받았습니다. .patch 파일 문서화 아이디어를 제공한 Nick Webson에게 감사드립니다.

---

면책 조항(Disclaimer)

이 저장소는 교육 목적으로만 제공됩니다.
정확성, 완전성 또는 특정 목적에의 적합성에 대해 어떠한 보증도 제공되지 않습니다. 사용에 따른 책임은 본인에게 있습니다—저자와 유지관리자는 이 코드의 사용, 수정 또는 배포로 인해 발생하는 손해, 법적 문제 또는 보증 위반에 대해 책임을 지지 않습니다.
잘못된 사용 또는 법적 위반에 대한 책임은 전적으로 사용자에게 있습니다.

---

작성자(Authors)

활성 유지관리자: Vinyzu
공동 유지관리자: Kaliiiiiiiiii