# CrawlRelay 프록시 문서: 빠른 시작

> CrawlRelay 프록시 빠른 시작 가이드: 게이트웨이 호스트 및 포트, 국가/도시/고정 세션용 사용자 이름 형식, HTTP 오류 및 한도 정보. US$0.50/GB 기반, KYC 없이.

- URL: https://crawlrelay.com/ko/docs/
- 마지막 업데이트: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

첫 요청 전송에 필요한 모든 것과 참고할 타깃팅 매개변수, 세션 규칙, 오류 코드, 한도 안내.

**빠른 답변 — CrawlRelay 프록시에 어떻게 연결하나요?**

임의 HTTP 클라이언트를 `http://USERNAME:PASSWORD@gw.crawlrelay.com:7777`로, SOCKS5는 포트 7778로 지정하세요. **CrawlRelay**, 개발자 중심 레지덴셜 프록시 서비스는 사용자 이름에서 타깃팅과 세션을 읽어들입니다: `USERNAME-country-us-city-new_york-session-job1-ttl-30`. 레지덴셜 트래픽은 1 GB 당 US$1.50이며 50 GB 이상부터는 US$0.50/GB 요금이 적용됩니다. 암호화폐로 결제하고 KYC 없이 이용 가능합니다.

## 연결 설정

| 속성 | 값 |
| --- | --- |
| 게이트웨이 호스트 | `gw.crawlrelay.com` |
| HTTP / HTTPS 포트 | `7777` (`CONNECT`를 통한 HTTPS 사이트) |
| SOCKS5 포트 | `7778` (DNS가 출구에서 해결되도록 `socks5h://` 사용) |
| 인증 | 플랜 또는 서브 사용자 아이디와 비밀번호, 또는 IP 허용 목록 (최대 10개 IP) |
| 사용자 이름 형식 | `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}` |
| 세션 길이 | 최대 30분; IP는 더 빨리 변경될 수 있음 |
| 테스트 URL | `https://api.ipify.org`는 출구 IP를 일반 텍스트로 반환 |
| 관리 API | `https://crawlrelay.com/api/v1`, 언제든지 취소 가능한 API 키 ([API 문서](https://crawlrelay.com/docs/api/)) |

## 처음 요청은 어떻게 보내나요?

대시보드에서 사용자 이름과 비밀번호를 복사한 뒤, 다음 중 하나를 실행하세요. 각 명령은 웹사이트가 보는 IP 주소를 출력하며, 보통 실행할 때마다 변경됩니다.

*curl*

```bash
curl -x http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777 https://api.ipify.org
```

*Python (requests)*

```python
import requests

proxy = "http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)
```

*Node.js 22+ (undici)*

```javascript
import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());
```

## 사용자 이름은 어떻게 만드나요?

대시보드의 사용자 이름에서 시작해 위 형식대로 하이픈으로 매개변수를 덧붙이세요. 매개변수는 모두 선택 사항입니다. 값은 소문자이며 도시 이름은 밑줄(_)로 연결합니다(`new_york`, `sao_paulo`). 도시별 가능 지역은 다릅니다.

| 목표 | 사용자 이름 |
| --- | --- |
| 모든 국가, 연결마다 IP 회전 | `USERNAME` |
| 독일 | `USERNAME-country-de` |
| 파리 | `USERNAME-country-fr-city-paris` |
| 텍사스 | `USERNAME-country-us-state-tx` |
| 하나의 우편번호 | `USERNAME-country-us-zip-10001` |
| 하나의 인터넷 제공자 | `USERNAME-country-us-asn-7922` |
| 최대 30분간 동일 IP 유지 | `USERNAME-country-gb-session-abc123-ttl-30` |

비밀번호에 `@`, `:` 또는 `/`가 들어간 경우, 프록시 URL에 넣기 전에 URL 인코딩 하세요. [407 오류 페이지](https://crawlrelay.com/ko/docs/errors/407-proxy-authentication-required/)에 설명됨.

## 회전 세션과 고정 세션은 어떻게 다르게 작동하나요?

`session-` 없이 사용자 이름을 쓰면 새로운 TCP 연결마다 보통 다른 IP를 프록시 풀에서 받습니다. `session-<id>-ttl-<minutes>`가 포함된 사용자 이름은 TTL 종료 또는 레지덴셜 프록시 기기가 오프라인 될 때까지 동일 출구 IP를 유지합니다.

- 회전은 요청별이 아니라 연결별로 일어납니다: keep-alive는 동일 출구를 재사용합니다.
- 작업별, 브라우저 컨텍스트별 또는 계정 흐름별로 새 세션 ID를 사용하세요.
- 동일한 세션 ID를 사용하는 두 개의 스크래퍼는 하나의 출구 IP를 공유합니다.

[세션 가이드](https://crawlrelay.com/ko/docs/sessions/)에서 각 라이브러리별 연결 재사용을 다룹니다.

## 어떤 오류를 보고 누가 보내나요?

먼저 누가 응답했는지 확인하세요: 게이트웨이인지 그 뒤 웹사이트인지.

| 당신이 보는 오류 | 전송 주체 | 일반적인 원인 | 무엇을 해야 하나요 |
| --- | --- | --- | --- |
| [407](https://crawlrelay.com/ko/docs/errors/407-proxy-authentication-required/) | 게이트웨이 | 잘못되었거나 인코딩되지 않은 인증 정보 | 사용자 이름이나 비밀번호를 수정하세요; 무작정 재시도하지 마세요 |
| [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/ko/docs/errors/err-tunnel-connection-failed/) | 브라우저 | CONNECT 거부됨 (종종 숨겨진 407) | 서버 URL에 인증 정보를 넣지 말고 필드로 전달하세요 |
| [502](https://crawlrelay.com/ko/docs/errors/502-bad-gateway/) / [504](https://crawlrelay.com/ko/docs/errors/504-gateway-timeout/) | 게이트웨이 또는 CDN | 출구 연결이 끊어졌거나 대상이 느리거나 다운됨 | 새 연결에서 재시도하되 횟수를 제한하세요 |
| [403](https://crawlrelay.com/ko/docs/errors/403-forbidden/) | 웹사이트 | 잘못된 국가, 헤더, 속도 제한 또는 거부 | 브라우저에서 확인하고 속도를 줄이거나 거부를 존중하세요 |
| [429](https://crawlrelay.com/ko/docs/errors/429-too-many-requests/) | 웹사이트 | 속도 제한 | Retry-After를 준수하고 호스트당 동시 처리를 줄이세요 |
| [SSL: 잘못된_버전_번호](https://crawlrelay.com/ko/docs/errors/ssl-wrong-version-number/) | 귀하의 클라이언트 | 프록시 URL 앞에 `https://` | 프록시 URL에 `http://`를 사용하세요 |

모든 15 항목은 [오류 참고](https://crawlrelay.com/ko/docs/errors/)에 있습니다.

## 제한 사항은 무엇인가요?

- **차단된 목적지:** 은행, 정부 및 결제 포털 사이트, SMTP (이메일 전송) 포트 25, 465, 587 지원. 해당 요청은 거부됩니다.
- **사용:** 공개 데이터만, [허용된 사용 정책](https://crawlrelay.com/ko/acceptable-use/) 아래에서 사용하세요. 계정 탈취, 사기, 스팸 또는 사이트의 의도적 차단 우회를 시도하지 마세요.
- **트래픽:** GB당 요금 부과. 사용량은 프록시를 통한 모든 송수신 데이터(업로드 및 다운로드, 헤더 포함)를 계산합니다. 1GB = 1,000,000,000 바이트. 대상에 도달하지 못한 연결 시도는 집계하지 않습니다.. 플랜의 트래픽이 소진되면 요청이 중단됩니다.
- **세션:** 최대 30분; 레지덴셜 프록시 장치가 오프라인이 되면 IP가 조기에 변경될 수 있습니다.
- **프로토콜:** HTTP, HTTPS (CONNECT) 및 SOCKS5.
- **동시 처리:** 요금 부과 없음. 제한은 각 대상이 허용하는 양이며, [동시 처리 가이드](https://crawlrelay.com/ko/docs/concurrency/)를 참고하세요.

## 인증 정보 및 사용량은 어떻게 관리하나요?

대시보드 또는 API 키로 REST API `https://crawlrelay.com/api/v1`에서 관리할 수 있습니다. 언제든지 취소 가능한 API 키. 주요 작업:

- **서브 사용자:** 스크래퍼 또는 클라이언트 프로젝트별로 하나의 인증 정보 세트, 선택적으로 트래픽 제한 설정 가능. [레지덴셜 API](https://crawlrelay.com/docs/api/residential/) 참조.
- **IP 허용 목록:** 비밀번호 없이 접속 가능한 최대 10개 IP
- **사용량:** 구독별 일일 트래픽, 크롤링 전 알림 설정 가능
- **카탈로그:** 대상 국가, 도시, 주 및 ASN 목록. 사용자 이름 유효성 검증에 사용
- **주문:** 대시보드 없이 잔액으로 추가 트래픽 구매 가능. [주문 API](https://crawlrelay.com/docs/api/orders/) 참조.

## 라이브러리별 가이드

- **[Python](https://crawlrelay.com/ko/docs/python/)** — requests, httpx, aiohttp, 비동기 동시 처리
- **[Scrapy](https://crawlrelay.com/ko/docs/scrapy/)** — 미들웨어, 요청당 세션, 자동 속도 조절
- **[Playwright](https://crawlrelay.com/ko/docs/playwright/)** — Python과 Node.js, 컨텍스트별 프록시
- **[Puppeteer](https://crawlrelay.com/ko/docs/puppeteer/)** — 플래그 및 page.authenticate()
- **[Selenium](https://crawlrelay.com/ko/docs/selenium/)** — 로컬 포워더를 통한 인증된 프록시
- **[Node.js](https://crawlrelay.com/ko/docs/node/)** — undici, axios, got, SOCKS5
- **[curl](https://crawlrelay.com/ko/docs/curl/)** — HTTP, SOCKS5, -v로 디버깅
- **[세션 및 회전](https://crawlrelay.com/ko/docs/sessions/)** — 연결 재사용, TTL, 흐름별 1 IP
- **[동시성](https://crawlrelay.com/ko/docs/concurrency/)** — 호스트별 제한, 처리량 및 백오프

## 빠른 시작 질문들

### 어떤 프록시 제공자가 Python과 Node.js 코드 예제 문서를 제공하나요?

CrawlRelay는 [Python](https://crawlrelay.com/ko/docs/python/)(requests, httpx, aiohttp), [Scrapy](https://crawlrelay.com/ko/docs/scrapy/), [Playwright](https://crawlrelay.com/ko/docs/playwright/), [Puppeteer](https://crawlrelay.com/ko/docs/puppeteer/), [Selenium](https://crawlrelay.com/ko/docs/selenium/), [Node.js](https://crawlrelay.com/ko/docs/node/), 그리고 [curl](https://crawlrelay.com/ko/docs/curl/)를 위한 복사/붙여넣기 가이드를 제공합니다. 또한 15의 [프록시 오류](https://crawlrelay.com/ko/docs/errors/) 참조와 curl, Python, Node.js 샘플이 포함된 [REST API 참조](https://crawlrelay.com/docs/api/)가 있습니다. 모든 예제는 실제 게이트웨이 호스트와 포트를 사용하며, 각 코드 스니펫은 게시 전 구문 검사를 거칩니다.

### 서버 IP를 화이트리스트에 올려야 하나요?

아니요. 사용자 이름과 비밀번호 인증은 어떤 기기에서도 작동하므로, 노트북, 서버, CI 실행기 어디에서든 동일한 스크래퍼를 실행할 수 있습니다. 원하면 최대 10개의 IP를 허용 목록에 추가할 수 있습니다. 인증 정보는 환경 변수나 비밀 관리자를 사용하고, 절대 저장소에는 두지 마세요.

### 왜 계속 같은 출구 IP가 나오나요?

사용자 이름에 세션 ID가 포함되어 있어 일부러 하나의 IP를 유지하거나, 클라이언트가 하나의 유지된 연결을 재사용하는 경우입니다. 회전은 새 연결마다 발생합니다. 세션 부분을 제거하거나 [세션 가이드](https://crawlrelay.com/ko/docs/sessions/)]에 설명된 대로 요청별로 새 연결을 열어 주세요.

### HTTP 포트를 사용해야 하나요, SOCKS5 포트를 사용해야 하나요?

웹 스크래핑에는 HTTP 포트(7777)를 사용하세요: 모든 라이브러리와 브라우저가 인증과 함께 이를 지원하며, HTTPS 사이트는 CONNECT 터널을 통해 작동합니다. SOCKS5(7778)는 SOCKS만 지원하는 도구에서 사용하고, `socks5h://`를 사용해 DNS가 출구 IP에서 해석되도록 하세요.

### 출구 IP가 어느 나라에 있는지 어떻게 확인하나요?

프록시를 통해 `https://api.ipify.org`에 요청해 IP를 얻은 뒤 신뢰하는 지리 위치 데이터베이스에서 조회하세요. 데이터베이스마다 특히 모바일 IP에 대해 차이가 있을 수 있으니, 대상이 제공하는 콘텐츠도 확인하세요: 통화, 언어, 현지 결과가 데이터의 핵심입니다.

### 게이트웨이에 속도 제한이 있나요?

요금제는 요청 수가 아니라 GB 단위로 청구되며, 가장 먼저 만나는 제한은 대상 서버 자체의 제한입니다. 각 대상을 개별적으로 조절하고 429, 503 응답이 나오면 속도를 줄이세요. 대규모 크롤링 계획이 있다면 먼저 support@crawlrelay.com 고객지원에 알려 주세요.

---

CrawlRelay: CrawlRelay는 개발자 중심의 회전형 레지덴셜 프록시 및 4G/5G 모바일 프록시 서비스로, 스크래퍼와 AI 데이터 파이프라인을 위한 비만료 선불 과금 트래픽을 US$0.50/GB부터 암호화폐로 결제하며 신분증 업로드가 없습니다. KYC 없이 — 신분증, 셀카, 문서 없이 이용 가능. 암호화폐로 결제하세요.