Proxy 포트

브라우저, 다운로드 도구, 기존 스크래퍼 등 proxy URL을 지원하는 모든 클라이언트에서 FourA의 출구를 통해 트래픽을 전송하세요. proxy 포트는 지정한 대상과의 터널을 열고 양방향으로 바이트를 복사하므로 스트림, 대용량 다운로드, 전체 브라우저 세션 등 JSON API가 지원하지 않는 항목을 처리할 수 있습니다.

베타. proxy 포트는 베타 상태입니다. 현재 트래픽 비용은 청구되지 않으며, 모니터링이나 가동 시간 보장 범위에 포함되지 않고, 옵션 이름이 변경될 수 있습니다. 문제가 발생하면 알려주시기 바랍니다.

연결

설정	값
Host	`proxy.foura.ai`
Port	`34004`
프로토콜	기본 인증을 사용하는 HTTP CONNECT
대상 포트	`443` 및 `80`

인증 정보는 대시보드에서 제공됩니다. 사이드바의 Proxy에서 proxy 사용자를 생성하면 생성된 사용자 이름과 비밀번호가 발급됩니다. 이는 의도적으로 API key와 분리되어 있습니다. proxy 핸드셰이크는 모든 연결에서 일반 텍스트로 전송되며, proxy 사용자는 API 연동에 영향을 주지 않고 순환(rotate)할 수 있기 때문입니다. Proxy Users를 참고하세요.

curl -x http://USERNAME:PASSWORD@proxy.foura.ai:34004 https://example.com

import requests

proxy = "http://USERNAME:PASSWORD@proxy.foura.ai:34004"
r = requests.get("https://example.com", proxies={"https": proxy, "http": proxy})
print(r.status_code)

해당 포트는 CONNECT만 지원합니다. https:// 대상은 모든 클라이언트에서 터널링됩니다. 일반 http:// 대상도 클라이언트가 이를 터널링할 때 정상 작동하지만(curl: --proxytunnel), 일반 request를 프록시로 직접 전달하는 클라이언트는 405 Method Not Allowed를 수신합니다.

옵션은 Username에 포함

자격 증명 뒤의 모든 항목은 순서에 관계없이 -key-value 쌍의 목록입니다.

USERNAME-network-residential-country-de-session-a1

값은 소문자 단어여야 합니다. 값 내의 대시는 새 옵션을 시작하므로 -city-new-york는 두 개의 옵션으로 해석되어 거부됩니다. 알 수 없는 키 역시 무시되지 않고 거부됩니다. 예를 들어 잘못 입력된 -contry-de는 잘못된 국가에서 처리되는 대신 지원되는 키를 명시하는 400 에러를 반환합니다.

Option	Values	What it does
`network`	`shared` (기본값, 별칭 `pool`), `residential`	주소가 제공되는 네트워크입니다. Shared는 플랜에 포함된 FourA 자체 출구 노드입니다. Residential은 플랜에 포함된 프리미엄 트래픽 및 추가 구매분에서 가져오는 가정용 주소입니다.
`fallback`	`residential`, `off`	Shared 네트워크 전용입니다. Shared 네트워크가 요청을 처리할 수 없을 때 residential 출구를 사용합니다. 명시적으로 요청하지 않으면 비활성화되며, 플랜에 프리미엄 트래픽이 포함되어 있고 잔여량이 있는 경우에만 작동합니다.
`country`	ISO 3166-1 alpha-2, 반복 가능	대상 사이트에 표시되는 출구 국가입니다. 여러 국가를 범위로 지정하려면 반복하십시오: `-country-de-country-fr`.
`session`	1~32자의 영문자, 숫자, 밑줄	이름을 공유하는 연결은 동일한 주소를 공유합니다 (sticky). 연결마다 새 주소를 사용하려면 생략하십시오 (rotating).
`state`	단어	지역(Region)입니다. Residential 전용입니다.
`city`	단어	도시(City)입니다. Residential 전용입니다.
`asn`	숫자	AS 번호 기준 네트워크입니다. Residential 전용입니다.
`os`	`windows`, `android`, `ios`, `mac`	주소가 속한 디바이스 종류입니다. Residential 전용입니다.
`lifetime`	`3` ~ `1440`	sticky residential 주소가 유지되는 시간(분)입니다. Residential 전용입니다.

network, fallback, session을 제외한 모든 옵션은 any을 허용하며, 이는 해당 단일 연결에 대해 proxy 사용자에 저장된 값을 지웁니다.

다음 세 가지 조합은 부분적으로 적용되지 않고 400 에러와 함께 거부됩니다:

Shared 네트워크에서의 state, city, asn, os 또는 lifetime 사용. Shared 네트워크는 국가 단위로만 선택할 수 있으며 더 세부적인 지정은 불가능합니다. 도시를 지정하려면 -network-residential을 추가하십시오.
-fallback-residential와 -network-residential 동시 사용. 대체(fallback) 대상 네트워크 자체에서는 fallback이 작동할 필요가 없습니다.
fallback이 활성화된 상태에서 더 세부적인 타겟팅 사용. fallback은 발생할 수도 있고 발생하지 않을 수도 있으므로, 간헐적으로만 적용될 수 있는 도시 지정은 거부됩니다.

세션

Shared 네트워크에서는 사용을 지속하는 한 슬라이딩 10분 윈도우 방식으로 이름이 지정된 세션이 동일한 출구를 유지합니다. 해당 출구가 작동을 멈추면 세션은 실패하는 대신 다른 출구로 이동합니다. 프록시 포트를 통해 구동되는 브라우저는 항상 세션 이름을 전달해야 합니다. 페이지 로드는 수십 개의 연결을 생성하며, 세션이 없으면 각 연결이 서로 다른 주소에서 나가게 됩니다.

Residential 네트워크에서 이름이 지정된 세션은 주소를 lifetime분 동안 또는 직접 설정하지 않은 경우 네트워크 기본값 동안 유지합니다.

저장된 기본값

대시보드의 proxy 사용자에 저장된 타겟팅은 해당 사용자로 설정된 모든 연결에 적용되므로 username을 짧게 유지할 수 있습니다. username에 지정한 모든 값은 해당 단일 연결에 우선 적용되며, any을 사용하면 저장된 값으로 되돌립니다. 저장된 residential 기본값은 플랜에서 허용하는 경우에만 비용이 차감됩니다. 그렇지 않으면 공유 네트워크를 통해 연결이 제공됩니다.

CONNECT 헤더

CONNECT request에 헤더를 추가할 수 있는 클라이언트는 동일한 옵션을 헤더로 전송할 수 있습니다. 헤더는 username의 동일한 옵션보다 우선 적용됩니다.

Header	동일 항목
`X-Foura-Network`	`-network-`
`X-Foura-Fallback`	`-fallback-` (`residential` 또는 `off`)
`X-Foura-Country`	`-country-`, 여러 개인 경우 쉼표로 구분
`X-Foura-Session`	`-session-`
`X-Foura-State`	`-state-`
`X-Foura-City`	`-city-`
`X-Foura-Asn`	`-asn-`
`X-Foura-Lifetime`	`-lifetime-`

curl -x http://USERNAME:PASSWORD@proxy.foura.ai:34004 \
  --proxy-header "X-Foura-Country: de" \
  https://example.com

응답

정상적으로 열린 터널은 200 Connection established(으)로 응답합니다. 모든 연결 거부 응답에는 한 줄의 원인이 적힌 X-Foura-Error 헤더가 포함되므로 다른 무엇보다 이 헤더를 먼저 확인하십시오.

상태	발생 조건
400 Bad Request	잘못된 형식의 request이거나 FourA에서 지원할 수 없는 옵션인 경우입니다. `X-Foura-Error`에 해당 옵션과 지원되는 값이 명시됩니다.
403 Forbidden	대상 포트가 지원되지 않거나 대상이 공용 인터넷 호스트가 아닌 경우입니다.
405 Method Not Allowed	CONNECT 대신 일반 request를 보낸 경우입니다.
407 Proxy Authentication Required	인증 정보가 누락되었거나 잘못된 경우입니다. 응답에는 어느 부분이 잘못되었는지 표시되지 않습니다.
408 Request Timeout	클라이언트가 연결된 후 15초 동안 아무것도 전송하지 않은 경우입니다.
429 Too Many Requests	프록시 사용자가 이미 200개의 터널을 열어 두었거나 포트의 용량 또는 생성 속도 한도에 도달한 경우입니다.
502 Bad Gateway	지정된 선택 시간 내에 해당 대상을 위한 유효한 출구를 찾지 못했거나 FourA 자체 리졸버가 호스트를 조회할 수 없는 경우입니다. 두 경우는 `X-Foura-Error`에서 서로 다른 메시지로 구분됩니다.
503 Service Unavailable	프록시 포트가 비활성화된 경우입니다.

제한 사항

프록시 사용자당 동시에 최대 200개의 터널을 열 수 있습니다.
출구를 찾는 데 최대 45초가 소요될 수 있으며, 이후 포트는 502 오류와 함께 시도를 중단합니다. 이미 출구가 지정된 세션은 대개 1초 이내에 연결됩니다.
양방향 모두에서 전송된 바이트가 없는 터널은 2분간 유휴 상태가 지속되면 닫힙니다.
대시보드에서 비활성화하거나 삭제한 프록시 사용자는 1분 이내에 인증이 중단됩니다.

사용량 측정

포트를 통과하는 바이트는 사용량 및 한도 페이지의 대역폭에 반영되며, 주거용 출구를 통과하는 바이트는 프리미엄 트래픽에도 반영됩니다. 프리미엄 허용량을 모두 소진한 후 -network-residential을(를) 지정하는 연결도 처리는 됩니다. 단, 이 상태에서는 대체 옵션이나 저장된 주거용 기본값이 적용되지 않으며 공유 네트워크가 대신 연결을 처리합니다.