Playwright 프록시 인증, 컨텍스트당 고정 IP 1개 할당
ProxyV4 엔지니어링 팀 작성 · Updated:
Playwright 프록시는 server, username, password를 포함하는 proxy 객체로 설정하며, Playwright가 별도의 확장 프로그램이나 래퍼 없이 프록시의 407 챌린지를 직접 처리합니다. 브라우저 전체에 적용하려면 launch()에 설정하고, 단일 브라우저 프로세스 내에서 격리된 컨텍스트마다 서로 다른 ProxyV4 IP를 부여하려면 newContext()에 설정하세요. Node.js나 Python 환경 모두에서 Chromium, Firefox, WebKit에 동일한 키가 적용됩니다.
proxy={ server: 'http://ip:port', username: 'user', password: 'pass' }- IP 1개US$1.85
- 3개 이상 IPUS$1.70
- 10개 이상 IPUS$1.60
- 25개 이상 IPUS$1.50
- 50개 이상 IPUS$1.40
- 100개 이상 IPUS$1.30
- 200개 이상 IPUS$1.20
- 500개 이상 IPUS$1.10
- IP 1개US$2.25
- 3개 이상 IPUS$2.10
- 10개 이상 IPUS$2.00
- 25개 이상 IPUS$1.90
- 50개 이상 IPUS$1.80
- 100개 이상 IPUS$1.70
- 200개 이상 IPUS$1.60
- 500개 이상 IPUS$1.50
프록시 객체, 키별 상세 설명
| 키 | 예시 값 | 설명 |
|---|---|---|
server | 'http://ip:port' | 주소 및 포트만 입력하며, 인증 정보는 이 문자열에 포함하지 않습니다 |
username | 'user' | ProxyV4 주문 내역의 사용자 이름 |
password | 'pass' | 프록시가 407 응답을 반환할 때 자동으로 전송됨 |
bypass | 'localhost,127.0.0.1' | 프록시를 거치지 않고 우회할 호스트 목록 (선택 사항) |
브라우저 전체 적용 vs 컨텍스트별 적용
chromium.launch()에 proxy를 전달하면 해당 브라우저의 모든 페이지가 하나의 IP를 통해 전송되므로, 단일 신원으로 단일 작업을 수행할 때 적합합니다. 반면 browser.newContext()에 전달하는 방식은 다중 계정 관리에 적합합니다. 각 컨텍스트가 독립된 쿠키, 스토리지, 프록시를 가지므로 단일 Chromium 프로세스 안에서 서로 다른 출구 주소를 나타내는 여러 세션을 동시에 운영할 수 있습니다.
모든 ProxyV4 전용 IPv4는 단 한 명의 고객에게만 대여되며 갱신 시에도 주소가 유지되므로, 설정 파일에서 컨텍스트 이름과 IP를 매핑해 두고 실행할 때마다 재사용할 수 있습니다. 지난주에 특정 IP로 계정 A에 접속했던 웹사이트는 오늘도 동일한 IP를 확인하게 됩니다.
컨텍스트 일관성을 유지하기 위한 세부 사항
- Windows 및 macOS의 일부 Playwright 및 Chromium 조합에서는 브라우저 실행 시 프록시가 함께 설정되지 않으면 컨텍스트별 프록시 적용을 거부할 수 있습니다. 이때는 플레이스홀더
proxy: { server: 'http://per-context' }로 브라우저를 실행한 뒤 각 컨텍스트에서 실제 프록시로 재정의하세요 newContext()에서 프록시의 국가에 맞게timezoneId와locale을 설정(예: 미국 IP는America/New_York, 베트남 IP는Asia/Ho_Chi_Minh)하여 시계와Intl출력이 IP 위치와 일치하도록 구성하세요- 텍스트 데이터만 필요한 경우
page.route()를 사용해 이미지와 글꼴을 차단하세요. 페이지 로딩이 빨라지고 실행 시간이 단축됩니다 - 더 이상 필요하지 않은 컨텍스트는 닫으세요. 각 컨텍스트마다 자체 연결이 열린 상태로 유지됩니다
단계별 안내
- 1
프록시 정보 분리하기
ProxyV4 주문 내역의
ip:port:user:pass형식에서ip:port는server에 입력하고, 마지막 두 항목은 각각username과password에 지정합니다. - 2
프록시가 적용된 컨텍스트 생성
const context = await browser.newContext({ proxy: { server: 'http://ip:port', username: 'user', password: 'pass' } })코드를 호출합니다. - 3
표준 시간대 및 언어 일치
동일한
newContext()옵션에 프록시 위치에 맞는timezoneId와locale을 추가합니다. - 4
IP 확인 엔드포인트 접속
const page = await context.newPage()를 실행하고https://proxyv4.com/api/my-ip로 이동하여 표시되는 주소가 프록시 IP인지 확인합니다. 동일한 컨텍스트에서 WebRTC 누출 테스트를 실행하면 더욱 확실하게 검증할 수 있습니다.
자주 묻는 질문
Playwright에서 'Proxy is only supported when browser is launched with a proxy'라는 오류가 발생합니다. 어떻게 해결하나요?
Windows 및 macOS에서는 Chromium이 실행 수준의 프록시를 먼저 설정해야 컨텍스트별 프록시를 허용하는 경우가 있습니다. chromium.launch({ proxy: { server: 'http://per-context' } })로 브라우저를 실행한 다음, 각 browser.newContext({ proxy })에 실제 주소와 로그인 정보를 입력하세요.
동일한 프록시 설정이 Firefox와 WebKit에서도 작동하나요?
네, 작동합니다. proxy: { server, username, password } 형식은 세 브라우저 엔진 모두와 Node.js 및 Python API에서 동일하게 사용되므로 실행 메서드(firefox, webkit)만 변경하면 됩니다.
헤드리스 브라우저 사용 시 트래픽 용량이 소진되나요?
ProxyV4 전용 IPv4 또는 고정 ISP 플랜에서는 소진되지 않습니다. 두 플랜 모두 대역폭이 무제한으로 제공되므로 데이터 소모가 큰 페이지를 방문해도 추가 요금이 발생하지 않습니다.
페이지가 로드되지 않고 터널 오류가 발생합니다. 무엇을 확인해야 하나요?
server 값에 http://와 올바른 포트가 사용되었는지, 대시보드에서 프록시가 활성 상태인지 확인하세요. 그 외의 원인은 터널 연결 가이드에서 확인하실 수 있습니다.
출처
Playwright 컨텍스트당 전용 IP 1개 제공
7개국 사용자 이름 및 비밀번호 인증 HTTP(S) 프록시, 무제한 트래픽, 갱신 시 동일 주소 유지.
미국 실시간 가격 확인