인증 프록시를 사용하는 Puppeteer: 실행 플래그 및 로그인 설정
ProxyV4 엔지니어링 팀 작성 · Updated:
Puppeteer 프록시 인증은 두 단계로 진행됩니다. 프록시 주소는 --proxy-server=http://ip:port 실행 플래그에 지정하고, 사용자 이름과 비밀번호는 await page.authenticate({ username, password })에 전달합니다. Chrome은 DevTools Protocol을 통해 해당 자격 증명으로 프록시의 407 인증 요청에 응답하므로, Node.js 스크립트에서 브라우저 확장 프로그램 없이 ProxyV4 IP를 사용할 수 있습니다.
--proxy-server=http://ip:port + page.authenticate({ username, password })- 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
Puppeteer 프록시 인증: 완전한 예제
첫 번째 탐색 전에 --proxy-server에 프록시 주소를 전달하고 page.authenticate()를 통해 로그인 정보를 전달하세요. 이 스크립트는 해당 작업을 정확히 수행하고 출구 IP를 출력하므로 한 번의 실행으로 프록시를 확인할 수 있습니다:
// npm i puppeteer
const puppeteer = require('puppeteer');
const PROXY = { host: 'IP', port: 'PORT', username: 'USER', password: 'PASS' };
(async () => {
const browser = await puppeteer.launch({
args: [`--proxy-server=http://${PROXY.host}:${PROXY.port}`],
});
try {
const page = await browser.newPage();
await page.authenticate({ username: PROXY.username, password: PROXY.password });
const res = await page.goto('https://proxyv4.com/api/my-ip', { waitUntil: 'domcontentloaded' });
console.log(res.status(), await page.evaluate(() => document.body.innerText));
} finally {
await browser.close();
}
})();출력 결과에 상태 200과 프록시 IP가 표시되어야 합니다. 407, ERR_TUNNEL_CONNECTION_FAILED가 나타나거나 본인의 실제 IP가 보인다면 두 단계 중 하나가 누락된 것입니다. 프록시 작동 안 함 페이지에서 도구별 일반적인 원인을 확인하세요.
로그인이 플래그에 포함되지 않는 이유
Chrome은 --proxy-server 내부에 인증 정보를 허용하지 않습니다. --proxy-server=http://user:pass@ip:port와 같이 작성하면 브라우저가 해당 값을 사용할 수 없어 일반적으로 ERR_NO_SUPPORTED_PROXIES 오류와 함께 요청이 실패합니다. 플래그에는 주소와 포트만 유지하고 로그인은 페이지에 전달하세요.
| 순서 | 호출 | 수행 작업 |
|---|---|---|
| 1 | puppeteer.launch({ args: ['--proxy-server=http://ip:port'] }) | 모든 요청이 사용할 프록시를 Chrome에 알림 |
| 2 | await page.authenticate({ username, password }) | 프록시가 407로 응답할 때 인증 정보 제공 |
| 3 | await page.goto(url, { waitUntil: 'domcontentloaded' }) | 인증된 프록시를 통해 대상 페이지 로드 |
탭, 컨텍스트 및 복수 IP 사용
page.authenticate()는 페이지별로 설정됩니다.browser.newPage()로 생성한 모든 탭은 첫 번째goto()를 호출하기 전에 개별적으로 호출해야 합니다.- 실행 플래그는 브라우저 전체에 대해 하나의 프록시를 고정합니다. 하나의 Chrome 프로세스에서 컨텍스트별로 다른 IP를 사용하려면, 각
http://user:pass@ip:port를proxy-chain패키지의anonymizeProxy()로 전달하고 그 결과를browser.createBrowserContext({ proxyServer })에proxyServer로 전달하세요. - 이 설정은
puppeteer-extra및puppeteer-extra-plugin-stealth에서도 동일하게 작동합니다. - 오류 경로를 포함해 항상
browser.close()로 종료하세요. 그렇지 않으면 서버에 headless Chrome 프로세스가 계속 쌓이게 됩니다.
SOCKS5 프록시와 Puppeteer
Chrome은 SOCKS5 프록시(--proxy-server=socks5://IP:PORT)를 사용할 수 있지만 로그인할 수는 없으며, page.authenticate()는 SOCKS에 적용되지 않습니다. ProxyV4 프록시의 경우(베트남 외 지역에서는 SOCKS5가 제공되며 베트남 IP는 HTTP 전용임) 두 가지 깔끔한 선택지가 있습니다. 주문을 HTTP 또는 듀얼 모드로 전환하여 위의 예제를 사용하거나, proxy-chain이 대신 로그인해 주는 비밀번호 없는 로컬 전달자를 열도록 하는 것입니다:
const proxyChain = require('proxy-chain');
const local = await proxyChain.anonymizeProxy('socks5://USER:PASS@IP:PORT');
const browser = await puppeteer.launch({ args: [`--proxy-server=${local}`] });
// ... when done:
await browser.close();
await proxyChain.closeAnonymizedProxy(local, true);IP 화이트리스트 로그인은 세 번째 방법입니다. 주문에 해당 기기의 공인 IP를 추가하면 Chrome이 인증 정보 없이 연결됩니다.
Puppeteer 플릿을 위한 IP 선택
Headless Chrome은 전체 페이지, 스크립트 및 이미지를 다운로드하므로 종량제 트래픽이 빠르게 누적됩니다. ProxyV4 전용 IPv4 및 고정 ISP 프록시는 대역폭 제한이 없으며, 각 IP는 한 명의 고객에게만 제공되고 갱신 시 동일한 주소가 유지되므로 세션이나 허용 목록이 연결되어 있을 때 유용합니다. 대상 사이트가 데이터센터 대역을 다르게 처리하는 경우 전용 IPv4 상품과 고정 ISP 상품을 비교해 보세요.
단계별 안내
- 1
프록시 주소로 Chrome 실행
ProxyV4 주문에서 발급받은 IP와 포트를 사용하여
const browser = await puppeteer.launch({ args: ['--proxy-server=http://ip:port'] });로 브라우저를 시작합니다. - 2
탭 인증 수행
const page = await browser.newPage();로 페이지를 열고 탐색(navigation)을 시작하기 전에await page.authenticate({ username: 'USER', password: 'PASS' });를 호출합니다. - 3
출구 IP 확인
await page.goto('https://proxyv4.com/api/my-ip');로 이동하여 응답에 프록시 주소가 표시되는지 확인합니다. - 4
브라우저 종료
실행 중인 Chrome 프로세스가 남지 않도록
await browser.close();로 종료합니다.
자주 묻는 질문
Puppeteer에서 ERR_NO_SUPPORTED_PROXIES 오류가 발생하는 원인은 무엇인가요?
--proxy-server=http://user:pass@ip:port처럼 플래그 내부에 인증 정보를 직접 포함했기 때문입니다. --proxy-server=http://ip:port를 사용하고 사용자 이름과 비밀번호는 page.authenticate()를 통해 전달하세요.
첫 번째 탭은 작동하는데 새 탭에서는 HTTP 407 오류가 발생합니다. 이유가 무엇인가요?
인증 정보는 페이지별로 저장됩니다. 새로 여는 각 페이지가 탐색을 시작하기 전에 await newTab.authenticate({ username, password })를 호출하세요.
하나의 Puppeteer 브라우저에서 여러 프록시를 동시에 사용할 수 있나요?
실행 플래그만으로는 불가능합니다. proxy-chain을 사용해 각 인증된 프록시를 로컬 주소로 변환한 뒤 브라우저 컨텍스트마다 고유한 proxyServer를 지정하거나, 프록시당 하나의 브라우저를 실행하세요.
Puppeteer에 적용하기 전에 여러 프록시를 테스트하려면 어떻게 해야 하나요?
이들을 프록시 체커에 붙여넣으세요. 한 번에 최대 100개까지 확인할 수 있으며 비밀번호는 저장되지 않습니다.
내 SOCKS5 프록시에서 page.authenticate()가 작동하지 않는 이유는 무엇인가요?
Chrome은 SOCKS5의 사용자 이름 및 비밀번호 로그인을 지원하지 않으므로 Puppeteer가 응답할 수 있는 부분이 없습니다. 주문의 HTTP 모드, proxy-chain을 통한 로컬 전달자, 또는 IP 화이트리스트 로그인을 사용하세요.
출처
headless Chrome을 위한 무제한 트래픽 IP
7개국 전용 IPv4 및 미국·베트남 고정 ISP 제공, 결제 즉시 자동 발급, IP당 단독 배정.
실시간 미국 가격 확인