Question 1

CDP로 연결할 때 window size가 screen-width 및 screen-height와 일치하지 않는 문제를 어떻게 수정하나요?

Accepted Answer

screen-width 및 screen-height 매개변수는 보고되는 화면 크기를 설정하지만 브라우저 창 크기를 조정하지는 않습니다. CloakBrowser/Chrome을 시작할 때 실행 플래그 --window-size=1920,1080을 추가하세요(원하는 너비와 높이를 사용하세요). 이렇게 하면 외부 창과 뷰포트가 기본 780px 너비 창 대신 요청한 크기를 사용하게 됩니다.

Question 2

크래시 후 CloakBrowser를 실행할 때마다 발생하는 'Target page, context or browser has been closed' 오류를 해결하는 방법은?

Accepted Answer

이 문제는 브라우저 프로세스가 정상적으로 종료되지 않은 채 강제 종료될 때(Task Manager, `kill`, 터미널 닫힘) 발생합니다. 무료 티어 시트는 15분 타임아웃 후 자동으로 해제될 때까지 점유된 상태로 유지되며, 그 시간 동안의 모든 실행은 첫 번째 `page.goto()`에서 아무 메시지 없이 종료됩니다.

해결 방법:
1. 래퍼를 v0.5.4 이상(최신 v0.5.8)으로 업그레이드하세요. 이렇게 하면 허용 수를 초과한 실행 시 단순한 `TargetClosedError` 대신 명확한 `CloakBrowserLicenseError`가 발생합니다: `pip install -U cloakbrowser`
2. 방치된 시트가 자동으로 해제될 때까지 최대 15분 동안 기다린 후 다시 실행하세요.
3. 항상 정상적으로 종료하여 시트가 즉시 해제되도록 하면 재발을 방지할 수 있습니다. 실행을 `try/finally` 또는 `with` 블록으로 감싸세요:
```python
from cloakbrowser import launch

browser = launch(headless=False)
try:
    page = browser.new_page()
    # ... 작업 내용 ...
finally:
    browser.close()
```
`try/finally`를 사용하면 예외가 발생하거나 `Ctrl+C`를 누르는 경우에도 시트가 즉시 해제됩니다.

Question 3

CloakBrowser에서 disable_non_proxied_udp에도 불구하고 --fingerprint-webrtc-ip가 여전히 직접 STUN UDP 트래픽을 통해 실제 IP를 유출하는 이유는 무엇인가요?

Accepted Answer

CloakBrowser Pro 151.0.7922.108.4에서 확인된 버그입니다: `--fingerprint-webrtc-ip`는 JavaScript에 표시되는 ICE candidate를 재작성하지만, 브라우저는 여전히 호스트에서 직접 STUN UDP 패킷을 전송하여 프록시를 우회합니다. `--force-webrtc-ip-handling-policy=disable_non_proxied_udp`와 `--webrtc-ip-handling-policy=disable_non_proxied_udp`를 설정해도 마찬가지입니다. **수정:** 대신 `--fingerprint-transparent-proxy`를 지정하여 실행하세요. 이 플래그는 연결을 프록시를 통해 터널링하고 프록시를 거치지 않는 UDP를 완전히 비활성화합니다(검증됨: 외부 인터페이스에서 STUN 패킷 0개, HTTPS는 여전히 프록시 경유). 이 플래그는 preview 채널에서 사용할 수 있으며 다음 stable 릴리스에 포함됩니다:

```js
{ releaseChannel: 'preview', args: ['--fingerprint-transparent-proxy', ...] }
```

그때까지는 `--fingerprint-webrtc-ip`를 생략하면 UDP 제한은 유효하게 유지되지만 실제 IP가 WebRTC에 그대로 노출됩니다. 따라서 transparent-proxy 플래그가 권장되는 해결 방법입니다.

Question 4

CloakBrowser/Playwright에서 사용자 지정 User-Agent와 navigator.userAgentData가 일치하지 않는 문제를 어떻게 수정하나요?

Accepted Answer

이것은 userAgent만 재정의해서는 해결할 수 없습니다. Playwright의 CDP 에뮬레이션은 navigator.userAgent와 레거시 HTTP UA 헤더만 변경합니다; navigator.userAgentData, sec-ch-ua, GREASE 브랜드 데이터는 실제 Chromium 바이너리 버전에서 생성됩니다. 예를 들어, Chromium 145 바이너리에서 Chrome/138 UA 문자열을 사용해도 userAgentData에서는 여전히 Chrome/145로 보고됩니다.

신호를 일관되게 유지하려면:

1. 다른 Chrome 버전으로 사용자 지정 UA를 설정하지 마세요.
2. GitHub Releases에서 필요한 버전과 일치하는 패치된 CloakBrowser 빌드를 다운로드하세요. 현재 사용 가능한 빌드에는 Chromium 142, 145, 146이 포함됩니다.
3. 해당 바이너리를 executablePath로 직접 실행하세요. 각 버전은 ~/.cloakbrowser/chromium-{version}/ 아래에 별도로 캐시됩니다.

예:

const browser = await chromium.launch({
  executablePath: "/Users/your-user/.cloakbrowser/chromium-145/CloakBrowser"
});

가중치가 적용된 버전 배포를 위해서는 여러 실제 바이너리를 나란히 실행하고 각 세션에 맞는 executablePath를 선택하세요. Chrome 138 또는 140과 같은 임의의 이전 버전은 제공되지 않습니다. 패치가 모든 릴리스에 백포트되지 않기 때문입니다.

Question 5

CloakBrowser의 fill()이 숫자를 입력할 때 자릿수가 누락되는 이유는 무엇인가요(예: 1999가 999가 됨)?

Accepted Answer

이것은 cloakbrowser@0.4.13의 humanize 오타(mistype) 기능에 있는 버그입니다. 시뮬레이션된 오타가 숫자에 발생하면, 대신 인접한 문자 키가 눌릴 수 있습니다. 숫자 입력 필드는 문자를 거부하므로, 이를 바로잡는 Backspace가 이전에 입력된 숫자를 삭제하여 1999 같은 값이 999로, 2000이 000으로 바뀌게 됩니다. 이 버그는 수정되었으며 다음 래퍼 릴리스에 포함될 예정입니다. 그 전까지는 명령어별로 humanize 설정을 재정의하여 해당 호출에 대한 오타를 비활성화하세요:

```js
await page.fill('#num', '1999', { human_config: { mistype_chance: 0 } });
```

모든 humanize 설정은 이 방법으로 호출별로 재정의할 수 있으며, 해당 단일 명령어에만 영향을 미칩니다.

CloakBrowser

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트