ProxyV4

인증 프록시를 사용하는 Puppeteer: 실행 플래그 및 로그인 설정

· Updated:

Puppeteer 프록시 인증은 두 단계로 진행됩니다. 프록시 주소는 --proxy-server=http://ip:port 실행 플래그에 지정하고, 사용자 이름과 비밀번호는 await page.authenticate({ username, password })에 전달합니다. Chrome은 DevTools Protocol을 통해 해당 자격 증명으로 프록시의 407 인증 요청에 응답하므로, Node.js 스크립트에서 브라우저 확장 프로그램 없이 ProxyV4 IP를 사용할 수 있습니다.

Puppeteer · HTTP
--proxy-server=http://ip:port + page.authenticate({ username, password })
전용 IPv4 (데이터센터)
🇺🇸 미국
재고 있음
최저
US$1.10 / IP / 월
수량별 할인 혜택
  • 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 오류와 함께 요청이 실패합니다. 플래그에는 주소와 포트만 유지하고 로그인은 페이지에 전달하세요.

순서호출수행 작업
1puppeteer.launch({ args: ['--proxy-server=http://ip:port'] })모든 요청이 사용할 프록시를 Chrome에 알림
2await page.authenticate({ username, password })프록시가 407로 응답할 때 인증 정보 제공
3await 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. 1

    프록시 주소로 Chrome 실행

    ProxyV4 주문에서 발급받은 IP와 포트를 사용하여 const browser = await puppeteer.launch({ args: ['--proxy-server=http://ip:port'] });로 브라우저를 시작합니다.

  2. 2

    탭 인증 수행

    const page = await browser.newPage();로 페이지를 열고 탐색(navigation)을 시작하기 전에 await page.authenticate({ username: 'USER', password: 'PASS' });를 호출합니다.

  3. 3

    출구 IP 확인

    await page.goto('https://proxyv4.com/api/my-ip');로 이동하여 응답에 프록시 주소가 표시되는지 확인합니다.

  4. 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당 단독 배정.

실시간 미국 가격 확인

Related articles

플랫폼별 프록시
웹 스크래핑용 프록시: 무제한 트래픽의 고정 IP 풀
Python, Scrapy, Playwright, Selenium용 웹 스크래핑 프록시. 전용 IPv4 및 고정 ISP 풀, 무제한 대역폭, 고정 IP 요금제 제공.
프록시 설정
Playwright 프록시 인증, 컨텍스트당 고정 IP 1개 할당
Node.js·Python의 Playwright 컨텍스트마다 인증 HTTP(S) 프록시를 설정하고, IP 기반 시간대와 로캘 일치 및 출구 주소를 확인하세요.
프록시 설정
Node.js 인증 프록시 연동: Axios, 네이티브 fetch 및 Got
Node.js·TypeScript 인증 HTTP(S) 프록시: Axios(https-proxy-agent), fetch(undici ProxyAgent), Got(hpagent).
무료 툴
사용 도구에 맞는 형식으로 프록시 목록 변환하기
브라우저에서 ip:port:user:pass, user:pass@ip:port, http:// URL, SOCKS5 URI, JSON, FoxyProxy 프록시 목록 일괄 변환.
플랫폼별 프록시
SEO 순위 추적용 프록시: 현지 검색 사용자에게 보이는 검색 결과를 직접 확인하세요
미국, 영국, 베트남, 일본 등 주요 시장의 전용 IPv4 프록시로 현지인에게 표시되는 실제 순위, 로컬 팩, 광고를 정확히 추적하세요.
플랫폼별 프록시
YouTube 프록시: 한 채널의 경고가 다른 채널로 번지는 위험 차단
다중 채널 크리에이터 및 팀을 위한 YouTube 프록시: 채널당 전용 고정 ISP 또는 IPv4를 할당하여 한 채널의 경고나 계정 해지가 다른 채널로 확산되는 것을 방지합니다.
IPV4 · united states
스크래핑, 순위 추적 및 광고 검수를 위한 미국 전용 IPv4 프록시 풀
미국 프라이빗 IPv4 프록시 구매: 고정 미국 데이터센터 IP, 단독 사용, 무제한 대역폭. 스크래핑, SERP 순위 추적 및 미국 광고 검증에 최적화되어 있습니다.
IPV4 · singapore
싱가포르 전용 IPv4 프록시: 스토어 및 광고 계정당 1개의 고정 IP
싱가포르 전용 IPv4 프록시: 단독 사용하는 고정 SG 데이터센터 IP로 Lazada 및 Shopee SG 스토어, 싱가포르 광고 계정 및 지역 자동화에 적합합니다.