# \[Enterprise] 프록시 자동 재시도

## 프록시 자동 재시도란?

대량의 데이터를 수집할 때는, 일부 요청이 네트워크 차단·타임아웃·IP 제한 등으로 인해 실패하는 경우가 발생할 수 있습니다.

**프록시 자동 재시도** 기능은 이러한 실패 상황에서도 성공률을 높여주는 엔터프라이즈 전용 기능입니다. 이 기능은 요청이 실패할 때마다 자동으로 다른 프록시 IP로 전환하여, **연결 안정성을 유지한 채 수집을 이어가는 방식**으로 작동합니다.

{% hint style="warning" %}
**유의사항**

엔터프라이즈 플랜의 프록시 기능은 별도 옵션으로 제공됩니다. 해당 기능을 이용하시려면, 별도로 구매한 프록시를 보유하고 계셔야 합니다. 프록시 설정 또는 구매 관련 문의는 설정창 내 \[프록시 구매] 버튼을 통하시거나, <hello@listly.io>로 문의해 주세요.
{% endhint %}

***

## 사용방법&#x20;

{% stepper %}
{% step %}

### 스크린샷을 이용해 추출 실패 원인 파악하기&#x20;

**그룹 추출, 자동 클릭, 자동 스크롤, 템플릿, 스케줄 태스크** 등 서버를 통해 실행되는 추출 작업 중 **웹사이트 차단으로 인해 수집이 실패한 경우**, 프록시 자동 재시도 기능을 통해 작업 성공률을 높일 수 있습니다.&#x20;

<figure><img src="/files/Ji72iSVajEphdOOAF6Ug" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
참고: 데이터 추출 실패 시 자동 생성되는 [스크린샷](/docs/ko/getting-started/databoard-features/screenshot.md)을 이용하면, 실패 시점의 페이지 상태와 에러코드를 확인하실 수 있습니다.&#x20;
{% endhint %}
{% endstep %}

{% step %}

### 추출 태스크의 설정창으로 이동해주세요.

태스크의 **설정창**에 진입합니다.

<figure><img src="/files/jwtOG74F6d3IoDhz8N8B" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 개인 프록시 섹션에서 재시도(프록시) 버튼을 클릭해주세요.

설정창의 **\[개인 프록시]** 섹션에서 **\[재시도(프록시)]** 옵션에 체크하여 기능을 활성화합니다.

<figure><img src="/files/Y4bjYvxw1tPNAdtOB1Xq" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 세부 옵션을 설정해주세요.

프록시 자동 재시도 옵션의 각 설명은 다음과 같습니다.

<mark style="color:red;">**A. 프록시 풀 선택**</mark>

<mark style="color:red;">➊</mark> All Private proxies : 등록된 모든 개인 프록시 중 사용 가능한 IP를 순차적으로 재시도합니다.

<mark style="color:red;">➋</mark> All Private proxies in same country : 선택한 프록시와 동일한 국가의 프록시만 사용합니다.

<mark style="color:red;">➌</mark> All Private proxies in same providers : 선택한 프록시와 동일한 제공업체(Provider)의 프록시만 사용합니다.

<mark style="color:orange;">**B. 요청 간격 선택**</mark>&#x20;

요청 간격은 자유롭게 지정할 수 있습니다. 단, 간격을 너무 짧게 설정할 경우 먼저 추출을 시도중인 프록시 서버의 작업이 끝나지 않은 상태에서 다음 요청이 중복될 수 있으므로, 웹 페이지의 데이터 양에 따라 적절히 작업 간격을 유지하는 것을 권장합니다.

<figure><img src="/files/SBtDVm4WQFsKeLIg8rRj" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### 선택한 설정값을 저장해주세요.

설정을 마치셨다면 설정창 하단의 **\[저장하기]** 버튼을 클릭합니다.

<figure><img src="/files/pONbQ9dIzMNDHqGnEYex" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 해당 태스크를 재추출해주세요.

설정값을 저장한 후, 태스크 목록에서 **\[재추출]** 아이콘을 클릭하면 설정된 프록시 자동 재시도 규칙이 적용된 상태로 수집이 다시 진행됩니다.

<figure><img src="/files/tlOzeTBBE60Lhe5FuHhO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 재추출 처리 결과를 확인해보세요.

추출이 완료된 후, 그룹 결과창에서 각 요청의 처리 결과를 확인할 수 있습니다. 표의 **재시도** 열에 표시된 숫자는 프록시 자동 재시도 과정의 기록을 의미합니다.\
\
표기방식은 <mark style="color:$success;">**성공차수**</mark>**&#x20;/ 프록시 풀 개수** 입니다. 예를들어 <mark style="color:$success;">**6**</mark>**&#x20;/ 15**로 표시된 경우, 설정에서 선택한 15개 프록시 서버 중 6번째 프록시에서 추출에 성공했다는 의미입니다.\
\
이 값을 통해 얼마나 많은 프록시 교체 시도가 있었는지, 특정 요청이 얼마나 민감하게 차단되었는지 등을 직관적으로 파악할 수 있습니다.<br>

<figure><img src="/files/KzJUKvcQSSmmFuOcbyA8" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.listly.io/docs/ko/getting-started/enterprise/proxy-auto-retry.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.