주거용 프록시 설정 방법을 토큰 발급부터 코드 예제까지 안내해요

주거용 프록시 설정 방법은 어떤 순서로 진행하나요?

주거용 프록시는 토큰 발급, 잔액 충전, 연결 정보 복사의 순서로 설정해요. 따로 설치할 프로그램은 없고, HTTP나 SOCKS5 프록시를 받는 도구라면 어디에나 바로 넣을 수 있어요.

1. 1회원 가입 페이지에서 계정을 만들면 접속 토큰이 하나 생겨요. 토큰은 로그인과 프록시 비밀번호로 함께 쓰여요.
2. 2토큰을 복사하거나 .txt 파일로 내려받아 안전한 곳에 저장해요. 서버에는 토큰의 해시와 마지막 4글자만 저장되기 때문에 직접 보관해 두어야 해요.
3. 3대시보드에서 잔액을 충전해요. 충전은 $20부터 할 수 있어요.
4. 4대시보드의 연결 만들기 화면을 열고 상품, 나라, 도시, 세션을 골라요.
5. 5화면에 나온 연결 형식 중 내 도구에 맞는 것을 복사해요.
6. 6curl 테스트 명령으로 IP와 나라가 맞는지 확인해요.

연결 만들기 화면은 고른 값으로 사용자 이름을 자동으로 만들어 주니 처음에는 그대로 복사해 쓰는 편이 가장 정확해요. 아래에서는 같은 내용을 직접 만드는 방법과 도구별 예제를 차례로 설명해요.

주거용 프록시 접속 주소와 연결 형식은 무엇인가요?

모든 상품은 접속 주소 gate.proxyour.com:7000 하나로 연결하고, 사용자 이름에는 고른 조건을, 비밀번호에는 접속 토큰을 넣어요. 프로토콜은 HTTP와 SOCKS5를 지원해요.

대시보드는 같은 연결 정보를 여러 형식으로 보여 줘요. 도구가 호스트, 포트, 사용자 이름, 비밀번호를 칸으로 나눠 받으면 첫 번째 형식을, 주소 한 줄로 받으면 두 번째나 세 번째 형식을 쓰면 돼요.

gate.proxyour.com:7000:user-country-us:YOUR_TOKEN
http://user-country-us:YOUR_TOKEN@gate.proxyour.com:7000
socks5://user-country-us:YOUR_TOKEN@gate.proxyour.com:7000

• host:port:username:password 형식: 칸이 나뉜 프록시 관리 도구와 브라우저 확장에 맞아요.
• http://username:token@gateway 형식: Python, Node.js, Scrapy처럼 주소 한 줄을 받는 코드에 맞아요.
• socks5://username:token@gateway 형식: SOCKS5만 받는 프로그램에 맞아요.

토큰에는 영문, 숫자, 밑줄, 하이픈만 들어가서 주소 안에 그대로 넣어도 돼요. 토큰은 비밀번호와 같으니 공개 저장소나 화면 공유에 노출되지 않게 환경 변수로 관리하는 습관을 들이면 좋아요.

SOCKS5 프록시로 연결하기

SOCKS5로 연결할 때도 접속 주소, 사용자 이름, 토큰은 그대로이고 주소 앞부분만 socks5로 바꾸면 돼요. HTTP 프록시를 받지 않는 프로그램에서 쓰기 좋아요.

curl -x socks5h://gate.proxyour.com:7000 -U "user-country-us:YOUR_TOKEN" https://ipinfo.io/json

# Python: pip install "requests[socks]"
proxy = "socks5h://user-country-us:YOUR_TOKEN@gate.proxyour.com:7000"
proxies = {"http": proxy, "https": proxy}

socks5h는 도메인 이름 확인까지 프록시 쪽에서 처리하는 방식이라 접속한 나라 기준의 결과를 받기 좋아요. Python에서 SOCKS5를 쓰려면 requests의 socks 추가 기능을 먼저 설치해요.

프록시 사용자 이름은 어떻게 구성되나요?

프록시 사용자 이름은 user로 시작하고, 필요한 조건을 하이픈으로 이어 붙여 만들어요. 나라, 도시, 세션, 모바일 IP 같은 조건이 모두 사용자 이름 안에 들어가요.

user-country-us
user-country-us-city-new_york
user-country-us-city-new_york-session-shop1
user-type-mobile-country-jp

조건을 빼면 그만큼 범위가 넓어져요. 나라만 넣으면 그 나라 안의 IP로, 세션을 넣지 않으면 요청마다 다른 IP로 연결돼요. 지원 나라와 도시는 나라별 프록시 페이지에서 확인할 수 있어요.

curl로 주거용 프록시 연결을 어떻게 테스트하나요?

가장 빠른 확인 방법은 curl로 ipinfo.io에 요청을 보내 돌아온 IP와 나라를 보는 거예요. 대시보드에도 같은 테스트 명령이 나와 있어서 그대로 붙여 넣으면 돼요.

curl -x http://gate.proxyour.com:7000 -U "user-country-us:YOUR_TOKEN" https://ipinfo.io/json

-x는 접속 주소, -U는 사용자 이름과 토큰을 콜론으로 이어 넣는 옵션이에요. YOUR_TOKEN 자리에 내 토큰을 넣고 실행하면 미국 주거용 IP 정보가 JSON으로 출력돼요.

명령을 두 번 실행해 IP가 바뀌면 회전 방식이 잘 작동하는 거예요. Windows, macOS, Linux 모두 기본으로 curl을 쓸 수 있어서 코드 작성 전에 연결부터 확인하기 좋아요.

Python에서 주거용 프록시는 어떻게 설정하나요?

Python requests에서는 proxies 딕셔너리에 http와 https 주소를 같은 프록시 주소로 넣으면 돼요. 프록시 주소 안에 사용자 이름과 토큰을 함께 적어요.

Python requests 예제

import requests

proxy = "http://user-country-us:YOUR_TOKEN@gate.proxyour.com:7000"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30)
print(r.json())

https 사이트에 접속할 때도 프록시 주소는 http://로 시작해요. 프록시와의 연결 방식이 HTTP이고, 실제 사이트와의 통신은 그 안에서 암호화되기 때문이에요.

Scrapy 예제

Scrapy에서는 요청의 meta에 proxy 값을 넣으면 기본 프록시 미들웨어가 인증 정보까지 처리해요. 웹 스크래핑이나 시장 조사처럼 많은 페이지를 모으는 작업에 잘 맞아요.

import scrapy


class IpSpider(scrapy.Spider):
    name = "ipcheck"

    def start_requests(self):
        yield scrapy.Request(
            "https://ipinfo.io/json",
            meta={"proxy": "http://user-country-de:YOUR_TOKEN@gate.proxyour.com:7000"},
        )

    def parse(self, response):
        self.logger.info(response.text)

Node.js에서 주거용 프록시는 어떻게 연결하나요?

Node.js에서는 undici의 ProxyAgent를 만들어 fetch 요청의 dispatcher로 넘기면 프록시를 통해 요청이 나가요. 인증은 token 옵션에 Basic 방식의 값을 넣어 처리해요.

// npm install undici
import { ProxyAgent, fetch } from "undici";

const username = "user-country-jp";
const token = "YOUR_TOKEN";

const agent = new ProxyAgent({
  uri: "http://gate.proxyour.com:7000",
  token: "Basic " + Buffer.from(username + ":" + token).toString("base64"),
});

const res = await fetch("https://ipinfo.io/json", { dispatcher: agent });
console.log(await res.json());

이 예제는 ES 모듈 형식이라 파일 이름을 .mjs로 하거나 package.json에 "type": "module"을 넣어 실행해요. 요청마다 다른 나라가 필요하면 사용자 이름만 바꾼 ProxyAgent를 따로 만들면 돼요.

Puppeteer와 Playwright에서는 프록시를 어떻게 설정하나요?

Puppeteer는 실행 옵션의 --proxy-server로 접속 주소를 넣고, page.authenticate로 사용자 이름과 토큰을 넣어요. Playwright는 launch의 proxy 옵션에 server, username, password를 함께 넣으면 돼요.

Puppeteer 예제

import puppeteer from "puppeteer";

const browser = await puppeteer.launch({
  args: ["--proxy-server=http://gate.proxyour.com:7000"],
});
const page = await browser.newPage();
await page.authenticate({ username: "user-country-fr", password: "YOUR_TOKEN" });

await page.goto("https://ipinfo.io/json");
console.log(await page.evaluate(() => document.body.innerText));
await browser.close();

Playwright 예제

import { chromium } from "playwright";

const browser = await chromium.launch({
  proxy: {
    server: "http://gate.proxyour.com:7000",
    username: "user-country-br",
    password: "YOUR_TOKEN",
  },
});
const page = await browser.newPage();
await page.goto("https://ipinfo.io/json");
console.log(await page.textContent("body"));
await browser.close();

브라우저 자동화는 광고 확인, SEO 순위 추적, 전자상거래 화면 점검처럼 실제 화면을 봐야 하는 작업에 잘 맞아요. 한 페이지에서 여러 요청이 나가니 같은 IP로 보이게 하려면 세션 이름을 붙여 쓰는 편이 안정적이에요.

브라우저나 운영체제에서 프록시를 설정하려면 어떻게 하나요?

브라우저나 운영체제에서는 프록시 설정 화면에 호스트와 포트를 넣고, 인증 창이 뜨면 사용자 이름과 토큰을 넣으면 돼요. gate.proxyour.com:7000 주소에서 콜론 앞은 호스트, 콜론 뒤는 포트예요.

1. 1인증을 받는 프록시 확장 프로그램을 설치하거나, 운영체제의 네트워크 설정에서 수동 프록시 항목을 열어요.
2. 2프로토콜은 HTTP 또는 SOCKS5를 골라요.
3. 3호스트와 포트 칸에 접속 주소를 나눠 넣어요.
4. 4사용자 이름 칸에 user-country-us 같은 값을, 비밀번호 칸에 토큰을 넣어요.
5. 5저장한 뒤 ipinfo.io에 접속해 IP와 나라를 확인해요.

Chrome은 기본적으로 운영체제의 프록시 설정을 따르기 때문에, 브라우저만 따로 쓰고 싶다면 확장 프로그램 방식이 편해요. 운영체제 설정을 쓰면 다른 앱의 트래픽도 프록시를 거쳐 GB 사용량이 늘 수 있으니 필요한 동안만 켜 두면 좋아요.

프록시 IP와 나라가 맞게 연결됐는지 어떻게 확인하나요?

프록시가 잘 연결됐는지는 ipinfo.io/json 결과의 ip, city, country 값을 보면 알 수 있어요. country가 사용자 이름에 넣은 나라 코드와 같으면 나라 지정이 잘 된 거예요.

{
  "ip": "...",
  "city": "New York",
  "region": "New York",
  "country": "US",
  ...
}

• country: 2글자 나라 코드예요. country-us로 요청했다면 US가 나와요.
• city: 도시를 지정했다면 그 도시 이름이 나와요.
• ip: 회전 방식이면 요청마다, 세션 방식이면 같은 세션 동안 같은 값이 나와요.

IP 조회 서비스마다 도시 정보가 조금씩 다르게 보일 수 있으니 나라 값을 먼저 기준으로 보면 돼요. 실제 작업 사이트에서도 지역 언어, 통화, 검색 결과가 맞게 나오는지 함께 확인하면 더 확실해요.

같은 IP를 유지하는 스티키 세션은 어떻게 설정하나요?

스티키 세션은 사용자 이름에 session-이름을 붙이면 같은 이름을 쓰는 동안 최대 120분 같은 IP로 연결되는 방식이에요. 세션 이름을 바꾸면 새 IP를 받아요.

# same session name: the same IP is kept (up to 120 minutes)
curl -x http://gate.proxyour.com:7000 -U "user-country-us-city-new_york-session-shop1:YOUR_TOKEN" https://ipinfo.io/json
curl -x http://gate.proxyour.com:7000 -U "user-country-us-city-new_york-session-shop1:YOUR_TOKEN" https://ipinfo.io/json

# new session name: a new IP
curl -x http://gate.proxyour.com:7000 -U "user-country-us-city-new_york-session-shop2:YOUR_TOKEN" https://ipinfo.io/json

Python에서 세션 나누기

import requests

def session_proxy(name):
    url = "http://user-country-us-session-" + name + ":YOUR_TOKEN@gate.proxyour.com:7000"
    return {"http": url, "https": url}

s = requests.Session()
s.proxies = session_proxy("cart1")
print(s.get("https://ipinfo.io/json", timeout=30).json()["ip"])
print(s.get("https://ipinfo.io/json", timeout=30).json()["ip"])  # same IP

장바구니, 로그인, 여러 단계로 이어지는 화면처럼 중간에 IP가 바뀌면 안 되는 작업에 세션을 써요. 한 달 동안 같은 주소가 필요하다면 고정 주거용 프록시가 더 잘 맞아요.

주거용 프록시 연결이 안 될 때는 어떻게 해결하나요?

연결 문제는 대부분 사용자 이름, 토큰, 나라 코드, 잔액 중 하나를 확인하면 해결돼요. 아래 순서로 하나씩 점검해 보세요.

• 407 Proxy Authentication Required: 토큰이나 사용자 이름이 틀린 경우예요. 토큰 앞뒤 공백과 user로 시작하는지 확인해요.
• 나라 코드: country 뒤에는 2글자 소문자 코드가 와요. 지원 나라인지도 함께 확인해요.
• 잔액: 잔액이 부족하면 연결이 이어지지 않으니 대시보드에서 잔액을 확인하고 충전해요.
• 도시 이름: 소문자, 띄어쓰기는 밑줄, 악센트 없는 철자(예: city-sao_paulo)로 썼는지 확인해요.
• 시간 초과: 새 세션 이름으로 다시 요청하면 다른 IP로 연결돼요. 코드에는 재시도와 넉넉한 timeout을 넣어 두면 좋아요.
• 형식: 주소 한 줄 형식이면 사용자 이름과 토큰 사이에 콜론, 토큰과 주소 사이에 @가 들어가는지 확인해요.

문제가 계속되면 대시보드의 연결 만들기에서 연결 정보를 새로 복사해 붙여 넣으면 철자 실수를 줄일 수 있어요. 그 밖의 질문은 자주 묻는 질문에 정리되어 있어요.