Socks5Proxy

프록시 연결 가이드, 언어와 도구별 SOCKS5·HTTP 설정 방법

Socks5Proxy 연결 가이드는 Python requests, Node.js, cURL, Selenium, Puppeteer, Playwright, Scrapy 7가지 도구에 SOCKS5와 HTTP 프록시를 연결하는 방법을 실제로 동작하는 코드와 함께 설명해요.

시작하기가격 보기
Python requestsPython requests에 HTTP 프록시와 SOCKS5 프록시(socks5h)를 연결하는 방법, 인증, 목록 순환, 재시도, 세션 관리까지 실제 코드로 정리했어요.Node.jsNode.js fetch(undici)에 HTTP 프록시를 ProxyAgent로, SOCKS5 프록시를 socks-proxy-agent로 연결하는 방법과 목록 순환 코드를 정리했어요.cURLcURL로 HTTP 프록시(-x)와 SOCKS5 프록시(--socks5-hostname)를 연결하는 방법, 인증, 응답 시간 측정, 목록 일괄 확인 스크립트를 정리했어요.SeleniumSelenium에서 Chrome과 Firefox에 HTTP·SOCKS5 프록시를 연결하는 방법, Chrome에서 IP 인증을 쓰는 이유와 설정, 여러 브라우저 병렬 실행을 정리했어요.PuppeteerPuppeteer에서 --proxy-server로 HTTP·SOCKS5 프록시를 연결하고 page.authenticate로 아이디와 비밀번호를 넘기는 방법, 브라우저별 IP 분리를 정리했어요.PlaywrightPlaywright에서 proxy 옵션으로 HTTP·SOCKS5 프록시를 연결하는 방법, 컨텍스트마다 다른 IP를 쓰는 방법, Python과 Node.js 예시를 정리했어요.ScrapyScrapy에서 HttpProxyMiddleware와 meta proxy로 프록시를 연결하는 방법, 요청마다 IP를 순환하는 다운로더 미들웨어, 속도 설정을 정리했어요.

프록시 연결에 필요한 정보는 무엇인가요?

프록시 한 줄에는 IP 주소, HTTP 포트, SOCKS5 포트, 아이디, 비밀번호가 들어 있어요. 대시보드의 내 프록시 화면에서 목록을 보거나 원하는 형식으로 내려받을 수 있고, API로도 같은 목록을 받을 수 있어요.

이 가이드의 모든 예시는 IP 198.51.100.23, HTTP 포트 8000, SOCKS5 포트 1080, 아이디 spx_user, 비밀번호 spx_pass를 써요. 198.51.100.0/24는 문서용으로 정해진 주소라서 실제로 연결되지 않으니, 내 프록시 목록의 값으로 바꿔 쓰면 돼요.

인증은 두 가지예요. 아이디와 비밀번호를 함께 보내는 방법과, 대시보드에 내 서버의 IPv4를 최대 10개까지 등록해 두고 ip:port만으로 접속하는 IP 인증이에요. 비밀번호를 받지 못하는 도구(예: Chrome 실행 인자)는 IP 인증을 쓰면 편해요.

항목예시 값설명
IP198.51.100.23프록시 서버 주소
HTTP 포트8000HTTP와 HTTPS(CONNECT) 연결
SOCKS5 포트1080SOCKS5 TCP 연결
아이디spx_user아이디·비밀번호 인증
비밀번호spx_pass아이디·비밀번호 인증

HTTP와 SOCKS5 중 무엇으로 연결하나요?

웹 페이지와 API를 요청하는 대부분의 작업은 HTTP 포트로 충분해요. HTTPS 주소도 CONNECT 방식으로 암호화된 채 전달되어 프록시가 내용을 바꾸지 않아요.

SOCKS5는 HTTP가 아닌 TCP 연결도 전달하고, 도메인 이름 확인을 프록시 쪽에서 하게 할 수 있어요. Python은 socks5h, cURL은 --socks5-hostname을 쓰면 내 서버의 DNS 요청이 밖으로 드러나지 않아요. 같은 IP에 두 포트가 모두 있으니 도구가 지원하는 방식을 고르면 돼요.

목록을 코드로 받아 쓰려면 어떻게 하나요?

API 키는 대시보드의 API 키 화면에서 만들고, 처음 한 번만 보여 주니 안전한 곳에 저장해 두세요. 모든 요청에 Authorization: Bearer 헤더로 키를 넣어요. 아래 코드는 SOCKS5용 목록을 user:pass@ip:port 형식으로 받는 Python 예시예요. 각 가이드에서 이 목록을 도구에 연결하는 방법을 이어서 설명해요.

import requests

API = "https://socks5proxy.io/api/v1"
KEY = "YOUR_API_KEY"

# Download the proxy list as plain text, one proxy per line
r = requests.get(
    API + "/proxies/download",
    params={"format": "user:pass@ip:port", "protocol": "socks5"},
    headers={"Authorization": "Bearer " + KEY},
    timeout=30,
)
r.raise_for_status()
proxies = [line.strip() for line in r.text.splitlines() if line.strip()]
print(len(proxies), "proxies loaded")

어떤 가이드부터 보면 되나요?

쓰는 언어와 도구에 맞는 가이드를 고르세요. 모든 가이드는 연결 확인 방법, 오류가 날 때 확인할 것, IP를 나눠 쓰는 방법을 함께 담고 있어요.

  • Python requests: 가장 간단한 HTTP·SOCKS5 연결과 목록 순환
  • Node.js: undici ProxyAgent(HTTP)와 socks-proxy-agent(SOCKS5)
  • cURL: 명령줄에서 연결 확인과 응답 시간 측정
  • Selenium: Chrome과 IP 인증, Firefox 설정
  • Puppeteer: --proxy-server와 page.authenticate
  • Playwright: 브라우저와 컨텍스트별 프록시
  • Scrapy: 요청마다 meta proxy와 순환 미들웨어

목록 형식은 어떤 것을 고르면 되나요?

도구마다 받는 형식이 달라서 목록을 내려받을 때 형식을 고를 수 있어요. 대부분의 라이브러리는 주소 형식(http://user:pass@ip:port 또는 socks5://user:pass@ip:port)을 그대로 받아요. 설정 칸이 IP, 포트, 아이디, 비밀번호로 나뉜 프로그램은 ip:port:user:pass 형식을 쓰면 줄을 쪼개 넣기 쉬워요.

IP 인증을 쓴다면 ip:port 형식을 고르면 돼요. 표 계산 프로그램이나 관리 문서에 붙여 넣을 때는 CSV 형식이 편해요. 같은 목록을 HTTP용과 SOCKS5용으로 따로 받을 수 있고, 포트만 다르게 나와요.

형식예시어울리는 곳
ip:port:user:pass198.51.100.23:8000:spx_user:spx_pass칸이 나뉜 설정 화면
user:pass@ip:portspx_user:spx_pass@198.51.100.23:8000코드에서 주소 조립
http://user:pass@ip:porthttp://spx_user:spx_pass@198.51.100.23:8000requests, cURL, Scrapy
socks5://user:pass@ip:portsocks5://spx_user:spx_pass@198.51.100.23:1080SOCKS5 라이브러리
ip:port198.51.100.23:8000IP 인증, 브라우저 실행 인자
CSVip,http_port,socks_port,user,pass,country표 계산, 관리 문서

프록시 정보는 어떻게 안전하게 보관하나요?

프록시 아이디와 비밀번호, API 키는 코드 저장소에 올리지 말고 환경 변수나 비밀값 저장소에 두세요. 저장소에 실수로 올라갔다면 대시보드에서 API 키를 새로 만들어 이전 키를 바로 쓸 수 없게 하면 돼요.

서버가 고정 IP라면 IP 인증을 쓰는 것이 가장 안전해요. 목록이 밖으로 새더라도 등록되지 않은 IP에서는 연결할 수 없어요. 등록 IP는 최대 10개까지 넣을 수 있고 언제든 바꿀 수 있어요.

팀원이 여러 명이라면 목록 파일을 공유 폴더에 두기보다, 각자 API로 받아 쓰게 하면 관리가 쉬워요. 목록을 받은 기록이 남아 문제가 생겼을 때 확인하기도 좋아요.

연결이 되지 않을 때는 무엇을 확인하나요?

먼저 cURL로 한 줄을 시험해 프록시 자체가 응답하는지 확인하세요. 407 응답은 아이디나 비밀번호가 틀렸다는 뜻이고, IP 인증을 쓰는 경우에는 요청을 보내는 서버의 IP가 등록 목록에 있는지 확인하세요. 연결 시간이 초과되면 포트(HTTP 8000, SOCKS5 1080처럼 줄마다 다른 값)를 다시 확인해 주세요.

그래도 해결되지 않으면 대시보드의 고객센터에서 문의할 수 있어요. 사용한 줄, 도구, 오류 메시지를 함께 남겨 주시면 빠르게 확인할 수 있어요.

프록시 연결 가이드, Python·Node.js·Selenium 설정 | Socks5Proxy