cURL, Python, Node.js에서 HTTP 또는 SOCKS5 프록시를 사용하는 방법

모든 IPronix 프록시는 사용자 이름과 비밀번호 인증을 사용합니다. 레지덴셜, 모바일, 데이터센터 게이트웨이에는 HTTP 포트와 SOCKS5 포트가 따로 있으며, 고정 ISP IP는 HTTP와 SOCKS5 중 한 번에 하나의 프로토콜로 작동합니다(주문 페이지에서 전환하며, IP와 포트는 그대로 유지됩니다). 고정 ISP 프록시는 내 프록시(My Proxies)에 표시됩니다. 레지덴셜, 모바일, 데이터센터 트래픽은 게이트웨이 호스트를 거치며, 타깃팅(국가, 지역, 도시, 세션)은 인증 정보 또는 대시보드에서 만든 엔드포인트 목록에 포함됩니다. 아래 예제는 문서용 주소 203.0.113.10과 예시 인증 정보를 사용하므로 본인의 정보로 바꿔서 사용하세요.

1. 프록시 URL 만들기

대부분의 도구는 스킴, 인증 정보, 호스트, 포트로 구성된 하나의 프록시 URL을 받습니다. HTTP 포트에는 http://를, SOCKS5 포트에는 socks5h://를 사용하세요(트래픽 게이트웨이는 두 포트가 서로 다르며, 고정 ISP IP는 먼저 프로토콜을 전환한 뒤 같은 포트를 사용합니다). socks5h의 h는 DNS 조회를 프록시가 수행한다는 뜻이므로, 대상의 호스트 이름이 로컬 리졸버로 노출되지 않습니다.

http://USER:PASS@203.0.113.10:8000
socks5h://USER:PASS@203.0.113.10:8001

비밀번호에 @, : 또는 / 같은 문자가 포함되어 있다면 먼저 URL 인코딩하세요(JavaScript에서는 encodeURIComponent, Python에서는 urllib.parse.quote 사용).

2. cURL

# HTTP proxy
curl -x http://USER:PASS@203.0.113.10:8000 https://api.ipify.org?format=json

# SOCKS5 proxy (DNS resolved by the proxy)
curl -x socks5h://USER:PASS@203.0.113.10:8001 https://api.ipify.org?format=json

응답에는 웹사이트에 보이는 IP 주소가 표시됩니다. 내 IP가 아니라 프록시의 IP여야 합니다.

3. Python (requests)

import requests

proxy = "http://USER:PASS@203.0.113.10:8000"
proxies = {"http": proxy, "https": proxy}
r = requests.get("https://api.ipify.org?format=json", proxies=proxies, timeout=30)
print(r.json())

SOCKS5를 사용하려면 SOCKS 추가 패키지를 설치하고 스킴을 변경하세요.

# pip install "requests[socks]"
proxy = "socks5h://USER:PASS@203.0.113.10:8001"
proxies = {"http": proxy, "https": proxy}

4. Node.js (axios)

import axios from "axios";
import { HttpsProxyAgent } from "https-proxy-agent";

const agent = new HttpsProxyAgent("http://USER:PASS@203.0.113.10:8000");
const { data } = await axios.get("https://api.ipify.org?format=json", {
  httpsAgent: agent,
  proxy: false, // let the agent handle the proxy
});
console.log(data);

SOCKS5를 사용하려면 대신 socks-proxy-agent를 사용하세요.

import { SocksProxyAgent } from "socks-proxy-agent";

const agent = new SocksProxyAgent("socks5h://USER:PASS@203.0.113.10:8001");
const { data } = await axios.get("https://api.ipify.org?format=json", {
  httpAgent: agent,
  httpsAgent: agent,
  proxy: false,
});

5. 자주 발생하는 오류 해결

• 407 Proxy Authentication Required: 사용자 이름 또는 비밀번호가 틀렸거나, 비밀번호의 특수 문자가 URL 인코딩되지 않았습니다.
• 연결이 즉시 거부되거나 재설정됨: 포트와 프로토콜이 맞지 않는 경우입니다. 예를 들어 SOCKS5 URL이 HTTP 포트를 가리키고 있을 수 있습니다. 사용하는 프로토콜에 맞는 포트를 복사하세요.
• 트래픽 상품에서 407 오류 발생: 키 뒤의 타깃팅 부분을 포함해 비밀번호 전체를 복사했는지 확인하세요. 지원되지 않는 국가, 지역 또는 도시는 거부됩니다.
• 트래픽 요청이 작동하지 않음: 패키지를 모두 사용했을 수 있습니다. 대시보드에서 남은 트래픽을 확인하고 추가로 구매하세요.
• 고정 ISP IP가 대기 중으로 표시됨: 아직 할당 중이며, 준비가 완료되면 주문에 표시됩니다.

고정 ISP 프록시는 주문 페이지의 핑(ping) 버튼으로 프록시가 응답하는지 확인하고 지연 시간도 볼 수 있습니다.