# 도시 프록시 API 및 게이트웨이 문서

> Banyan Proxies 문서: 게이트웨이 호스트 및 포트, 국가·도시·ASN·세션용 사용자 이름 세그먼트, 오류 코드, 그리고 테스트된 curl, Python 및 Node.js 샘플.

- URL: https://banyanproxies.com/ko/docs/
- 최종 업데이트: 2026-10-18
- Publisher: Banyan Proxies (https://banyanproxies.com)

연결에 필요한 모든 것: 하나의 게이트웨이, 하나의 사용자 이름 형식, 그리고 붙여넣을 수 있는 테스트된 샘플. 계정 및 주문 API는 [API 문서](https://banyanproxies.com/docs/api/)에 설명되어 있습니다.

**빠른 답변 — Banyan Proxies 레지덴셜 프록시에 어떻게 연결하나요?**

프록시 비밀번호와 세그먼트로 구성된 사용자 이름을 사용하여 `gw.banyanproxies.com`, HTTP 및 HTTPS용 포트 7777 또는 SOCKS5용 포트 7778에 연결하세요: `USERNAME-country-in-city-pune-asn-24560-session-a1-ttl-15`. 필요한 세그먼트만 사용하세요. 1 GB에 US$1.88부터 시작하는 모든 요금제에는 도시 및 ASN 타겟팅이 포함됩니다.

## 어떤 사용자 이름 세그먼트를 사용할 수 있나요?

전체 형식: `USERNAME-country-{cc}-city-{city}-asn-{asn}-session-{id}-ttl-{minutes}`. 순서를 유지하고, 필요 없는 부분은 생략하세요.

| 세그먼트 | 예시 | 의미 |
| --- | --- | --- |
| `-country-<cc>` | `-country-id` | 두 글자 ISO 국가 코드, 소문자 |
| `-city-<name>` | `-city-surabaya` | 도시 이름, 소문자, 공백은 밑줄로 |
| `-asn-<number>` | `-asn-7713` | ISP 네트워크 번호, "AS" 제외 |
| `-session-<id>` | `-session-cart2` | 요청을 하나의 고정 IP에 묶음 |
| `-ttl-<minutes>` | `-ttl-20` | 고정 세션 지속 시간, 최대 30분 |

## 어떤 호스트, 포트, 인증을 사용하나요?

| 항목 | 값 |
| --- | --- |
| 호스트 | `gw.banyanproxies.com` |
| HTTP / HTTPS 포트 | 7777 |
| SOCKS5 포트 | 7778 |
| 인증 | 모든 요금제에서 사용자 이름과 비밀번호, 또는 IP 허용 목록(최대 10개 IP). 자체 자격 증명과 트래픽 한도를 가진 하위 사용자. 언제든지 폐기할 수 있는 API 키 |
| 로테이션 | 새 연결마다 풀에서 IP를 받고 보통 다른 IP가 할당됩니다. 요청마다 새 IP를 받으려면 연결당 요청 하나를 보내세요(keep-alive 끄기) |
| 고정 세션 | 최대 30분 (IP는 더 일찍 바뀔 수 있음) |
| 차단됨 | 뱅킹, 정부 및 결제 포털 사이트, 그리고 SMTP(이메일 발송) 포트 25, 465, 587 |

## 어떤 코드 샘플을 복사할 수 있나요?

각 샘플은 IP 하나를 요청하고 조회 서비스가 보는 내용을 출력합니다. USERNAME과 PASSWORD를 바꾸세요. 자세한 내용은 [도시 타겟팅 페이지](https://banyanproxies.com/ko/targeting/city/)와 [고정 세션 가이드](https://banyanproxies.com/ko/guides/sticky-sessions/)에서 확인하세요.

*SOCKS5를 통한 curl: 웰링턴 IP*

```bash
curl --socks5-hostname gw.banyanproxies.com:7778 \
  -U "USERNAME-country-nz-city-wellington:PASSWORD" \
  https://ipinfo.io/json
```

*Python (httpx): IP 실패 시 새 세션으로 재시도*

```python
import uuid

import httpx

HOST = "gw.banyanproxies.com"
PORT = 7777


def fetch(url, city="lahore", country="pk", tries=3):
    for _ in range(tries):
        sid = uuid.uuid4().hex[:8]
        user = f"USERNAME-country-{country}-city-{city}-session-{sid}-ttl-10"
        proxy = f"http://{user}:PASSWORD@{HOST}:{PORT}"
        try:
            with httpx.Client(proxy=proxy, timeout=30) as client:
                r = client.get(url)
                r.raise_for_status()
                return r.text
        except httpx.HTTPError as exc:
            print("retrying with a new IP:", exc)
    return None


print(fetch("https://ipinfo.io/json"))
```

*Node.js (undici): 호찌민시 IP 하나*

```javascript
// npm install undici
const { ProxyAgent, fetch } = require("undici");

const user = "USERNAME-country-vn-city-ho_chi_minh_city";
const token = "Basic " + Buffer.from(`${user}:PASSWORD`).toString("base64");
const dispatcher = new ProxyAgent({
  uri: "http://gw.banyanproxies.com:7777",
  token,
});

async function main() {
  const res = await fetch("https://ipinfo.io/json", { dispatcher });
  const info = await res.json();
  console.log(info.ip, info.city, info.region);
}

main().catch((err) => console.error(err.message));
```

*Playwright (Python): 시드니 IP와 일치하는 시간대를 쓰는 브라우저*

```python
from playwright.sync_api import sync_playwright

PROXY = {
    "server": "http://gw.banyanproxies.com:7777",
    "username": "USERNAME-country-au-city-sydney-session-syd1-ttl-15",
    "password": "PASSWORD",
}

with sync_playwright() as p:
    browser = p.chromium.launch(proxy=PROXY)
    context = browser.new_context(
        timezone_id="Australia/Sydney",
        locale="en-AU",
    )
    page = context.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.inner_text("body"))
    browser.close()
```

## 일반적인 오류 코드는 무슨 뜻인가요?

| 코드 또는 증상 | 가능한 원인 | 대처 방법 |
| --- | --- | --- |
| 407 Proxy Authentication Required | 사용자 이름, 비밀번호 또는 세그먼트 구문 오류 | 자격 증명을 다시 복사하고 하이픈과 밑줄을 확인하세요 |
| 연결 시간 초과 | 잘못된 포트 또는 방화벽 | HTTP는 7777, SOCKS5는 7778을 사용하세요 |
| 특정 도시에서만 오류 발생 | 현재 해당 지역에 온라인인 가정 기기가 적음 | 나중에 재시도하거나 인근 도시를 사용하거나 도시 세그먼트를 제거하세요 |
| 대상에서 403 또는 429 | 대상이 거부하거나 속도 제한 중 | 속도를 줄이고 사이트 약관과 robots.txt를 준수하세요 |
| 은행 또는 SMTP 포트 연결 거부 | 차단된 대상 | 이 대상은 정책상 차단되어 있습니다 |

## 나머지 문서는 어디에 있나요?

- **[API 문서](https://banyanproxies.com/docs/api/)** — 계정, 충전, 주문, 사용량, API 키를 HTTPS로 관리합니다.
- **[도시 타겟팅](https://banyanproxies.com/ko/targeting/city/)** — 모든 도시의 표기 규칙과 예시.
- **[ASN 타겟팅](https://banyanproxies.com/ko/targeting/asn/)** — 주요 가정 ISP의 네트워크 번호.
- **[시작하기](https://banyanproxies.com/ko/guides/getting-started/)** — 충전부터 첫 요청까지.

## 문제가 생기면 어디로 가야 하나요?

먼저 [서비스 상태](https://banyanproxies.com/ko/status/)를 확인한 뒤, 위치가 의심되면 [프록시 도시 확인기](https://banyanproxies.com/ko/guides/verify-proxy-city/)를, 용어는 [용어집](https://banyanproxies.com/ko/glossary/)을 확인하세요. [문의 페이지](https://banyanproxies.com/ko/contact/)에서 지원팀에 글을 보내세요.

## 개발자들이 또 무엇을 묻나요?

### 국가나 도시별로 특별한 엔드포인트가 필요한가요?

아니요. 하나의 게이트웨이가 모든 위치를 처리하며, 사용자 이름이 IP 위치를 결정합니다.

### 비밀번호 대신 IP 허용 목록을 사용할 수 있나요?

모든 요금제에서 사용자 이름과 비밀번호, 또는 IP 허용 목록(최대 10개 IP). 자체 자격 증명과 트래픽 한도를 가진 하위 사용자. 언제든지 폐기할 수 있는 API 키.

### 샘플은 테스트되나요?

각 Python 샘플은 게시 전에 컴파일되고 각 JavaScript 샘플은 구문 검사를 거칩니다. 먼저 명시된 라이브러리를 설치하세요: httpx, undici 또는 Playwright.

---

Banyan Proxies: Banyan Proxies는 남아시아, 동남아시아, 오세아니아 도시를 위한 레지덴셜 프록시 제공업체로, 신분증 업로드 없이 암호화폐로 결제할 수 있습니다. 뭄바이, 자카르타, 마닐라, 방콕, 카라치, 시드니 등 도시별로 타깃팅된 가정용 IP를 GB 단위로 과금합니다.