Node.js 인증 프록시 연동: Axios, 네이티브 fetch 및 Got
ProxyV4 엔지니어링 팀 작성 · Updated:
Axios에서 Node.js 프록시를 안정적으로 사용하는 방법은 httpsAgent로 HttpsProxyAgent를 전달하고 proxy: false를 함께 설정하는 것입니다. Axios 자체의 proxy: { host, port } 설정은 HTTP CONNECT 터널을 열지 않으므로 https:// URL에서 오류가 발생하며, 네이티브 fetch()에는 대신 undici의 ProxyAgent가 필요합니다. 이 페이지에서는 각 클라이언트를 ProxyV4 http://user:pass@ip:port URL과 함께 사용하는 방법 및 송출 IP를 확인하는 방법을 설명합니다.
new HttpsProxyAgent('http://user:pass@ip:port')- 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
사용 중인 HTTP 클라이언트에 맞는 코드 스니펫 선택
세 클라이언트 모두 동일한 프록시 URL 형식을 사용합니다. 주문 정보에 있는 ip:port:user:pass 형식으로 URL을 생성하세요. 클라이언트가 프록시와 HTTP로 통신하며 TLS 터널을 생성하므로 스키마는 http://로 유지됩니다.
| 클라이언트 | 설치 | 프록시 연결 |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
Native fetch (Node 18+) | npm i undici | fetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') }) |
| Got | npm i hpagent | got(url, { agent: { https: new HttpsProxyAgent({ proxy: 'http://user:pass@ip:port' }) } }) |
Axios에서 `proxy: false`가 중요한 이유
Axios는 자체적으로 HTTP_PROXY 및 HTTPS_PROXY 환경 변수를 확인합니다. 시스템(CI 러너나 컨테이너 등)에 해당 환경 변수가 설정되어 있는 상태에서 에이전트까지 함께 전달하면 두 설정이 충돌하게 됩니다. proxy: false를 지정하면 Axios가 환경 변수와 기본 프록시 로직을 무시하므로, 에이전트 설정만 단독으로 요청 경로를 제어하게 됩니다.
다수의 요청에서 에이전트 재사용하기
- 요청 루프 외부에서 프록시 IP당 하나의 에이전트를 생성하세요. 에이전트는 keep-alive 소켓을 유지하지만, 호출마다 에이전트를 새로 생성하면 소켓이 폐기됩니다.
- 프록시가 여러 개인 경우 매번 즉석에서 에이전트를 생성하지 말고, IP와 에이전트를 매핑한
Map을 유지하여 가져와 사용하세요. - 응답이 지연되는 대상 하나로 인해 워커가 무한정 대기하지 않도록 모든 호출에
timeout(예: Axios의 경우timeout: 10000)을 설정하세요. - 프록시 목록 데이터 변환이 필요하신가요? 프록시 형식 변환기를 사용하면
ip:port:user:pass문자열을require또는import할 수 있는 JSON 배열로 변환할 수 있습니다.
안정적인 IP가 Node.js 작업에 제공하는 이점
ProxyV4 전용 IPv4는 대여 기간 내내 단 한 명의 고객에게만 할당되며 갱신 시에도 동일한 주소가 유지되므로, 해당 IP에 연결된 허용 목록 API, 로그인 세션 또는 요청 속도 제한 할당량이 배포 간에도 유효하게 유지됩니다. 대역폭은 무제한이므로 장시간 실행되는 워커 작업을 예측 가능한 비용으로 운용할 수 있습니다. 크롤링 패턴 및 속도 조절에 대한 자세한 내용은 웹 스크래핑 활용 사례를 참조하세요.
단계별 안내
- 1
클라이언트 및 에이전트 설치
프로젝트에서
npm install axios https-proxy-agent를 실행하세요(네이티브fetch를 사용하는 경우npm install undici실행). - 2
에이전트 1회 생성
ProxyV4 주문 정보의 값을 사용하여
const agent = new HttpsProxyAgent('http://user:pass@ip:port');를 생성합니다. - 3
에이전트를 통한 요청 전송
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });를 호출합니다. - 4
IP 확인 및 비교
console.log(res.data)에 프록시 IP가 출력되어야 합니다. 서버 자체의 주소가 출력된다면 에이전트가 적용되지 않은 것입니다.
자주 묻는 질문
Axios의 proxy: { host, port, auth } 설정이 HTTPS 사이트에서 실패하는 이유는 무엇인가요?
해당 옵션은 HTTP CONNECT 터널을 먼저 요청하지 않고 프록시로 일반 HTTP 요청을 전송하기 때문에 대상 서버와의 TLS 연결이 정상적으로 수립되지 않습니다. 대신 httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port')를 사용하고 proxy: false를 설정하세요.
Node 18, 20, 22 버전의 네이티브 fetch()에 프록시를 추가하려면 어떻게 해야 하나요?
Node의 fetch는 undici 기반으로 동작하므로 undici에서 ProxyAgent를 가져온 후 fetch() 옵션의 일부로 { dispatcher: new ProxyAgent('http://user:pass@ip:port') }를 전달하세요.
비밀번호에 @ 또는 : 문자가 포함되어 있으면 URL이 깨지나요?
그럴 수 있습니다. 해당 문자는 URL 내에서 특수 용도로 사용되기 때문입니다. http://user:pass@ip:port를 구성하기 전에 encodeURIComponent(password)를 사용하여 비밀번호를 퍼센트 인코딩하세요.
요청 시 407 오류가 반환됩니다. 무엇이 문제인가요?
프록시가 응답했으나 로그인을 거부한 상태입니다. 주문 정보에 있는 사용자 이름과 비밀번호를 다시 확인하세요. 자세한 일반적 원인은 407 문제 해결 페이지에서 확인할 수 있습니다.
출처
Node.js 워커를 위한 고정 IPv4
7개국 전용 IPv4 및 미국·베트남 고정 ISP 프록시를 무제한 트래픽과 IP당 1인 전용으로 제공합니다. 1개부터 대량 구매까지 가능합니다.
실시간 미국 가격 확인