# Chrome 확장 프로그램 (베타)

> URL: https://foura.ai/ko/docs/dashboard/chrome-extension
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

FourA Chrome 확장 프로그램은 브라우저에 두 가지 도구를 제공합니다. **팝업**은 [proxy 포트](https://foura.ai/docs/api/proxy-port)에서 Chrome 트래픽을 proxy 사용자 중 하나를 통해 라우팅합니다. **DevTools의 FourA 탭**은 페이지의 모든 request를 바로 사용 가능한 API 호출로 변환합니다.

이 확장 프로그램은 베타 버전입니다. 아직 Chrome 웹 스토어에 등록되지 않아 Chrome 개발자 모드로 설치해야 하며, 화면 구성과 설정은 변경될 수 있습니다. Chrome 116 이상 버전이 필요하며 Free 플랜을 포함한 모든 플랜에서 작동합니다.

## 설치

zip 파일은 대시보드에 있습니다. 사이드바의 **도구** 아래에서 **확장 프로그램**을 열고 **다운로드**를 클릭하세요.

1. zip 파일을 다운로드하고 압축을 풉니다. 압축을 푼 폴더는 그대로 유지하세요. Chrome이 해당 폴더에서 확장 프로그램을 로드합니다.
2. `chrome://extensions`를 열고 오른쪽 상단의 **개발자 모드**를 켭니다.
3. **압축해제된 확장 프로그램을 로드합니다**를 클릭하고 압축을 푼 폴더를 선택합니다.
4. 툴바의 퍼즐 아이콘에서 FourA를 고정합니다. FourA가 꺼져 있을 때는 아이콘이 회색이고, 라우팅 중일 때는 녹색 점이 표시됩니다.

### 업데이트

확장 프로그램은 1시간마다 한 번씩, 그리고 팝업을 열 때마다 새 버전을 확인합니다. 팝업 설정의 **버전** 아래에 있는 **지금 확인**을 누르면 즉시 확인합니다. 새 버전이 출시되면 팝업에 버전 정보와 함께 **다운로드** 버튼이 표시됩니다. 새 버전의 압축을 풀고 **압축해제된 확장 프로그램을 로드합니다**로 해당 폴더를 선택하세요. 새 버전 폴더 위치와 관계없이 FourA가 기존 설정을 유지한 채 업데이트됩니다. 현재 폴더 위에 압축을 풀었다면 **FourA 다시 로드**만으로 충분합니다. 0.3.1 이하 버전에서 업데이트하는 경우 새 카드로 한 번 설치됩니다. proxy 사용자를 다시 선택하고 기존 카드를 삭제하세요.

## 시작하기 전에

- proxy 사용자가 필요합니다. 대시보드의 **Proxy** 페이지에서 생성하세요. [Proxy](https://foura.ai/docs/dashboard/proxy)를 참조하세요.
- 동일한 Chrome 브라우저에서 대시보드에 로그인되어 있어야 합니다. 확장 프로그램은 대시보드에서만 proxy 사용자를 읽어옵니다. 열려 있는 대시보드 탭이 없으면 백그라운드에서 탭을 열어 정보를 읽은 후 다시 닫습니다.

## FourA를 통해 탐색

팝업에는 **연결**, **위치**, **설정** 세 페이지가 있습니다.

### 연결

1. 툴바에서 FourA를 열고 이 브라우저에서 사용할 proxy 사용자를 선택합니다.
2. 큰 스위치를 누릅니다.
3. **사이트에 표시되는 주소**를 확인합니다. FourA는 설정값으로 추정하지 않고 터널을 통해 해당 주소를 직접 측정한 후, 비교를 위해 옆에 **내 주소**를 함께 표시합니다.

**이번 기간 트래픽**에는 플랜의 proxy 트래픽 중 사용한 양이 표시됩니다.

### 위치

- **Network:** **Shared**(자체 풀, 플랜 트래픽) 또는 **Premium**(주거용 주소, 플랜의 프리미엄 트래픽에서 차감). Shared 상태에서 **Use premium when shared cannot carry a page**를 켜면 공유 네트워크가 요청을 처리할 수 없을 때 프리미엄 출구를 사용합니다. 플랜에 프리미엄 트래픽이 포함되어 있고 잔여 용량이 있을 때만 동작합니다.
- **Country:** 기본값은 모든 국가입니다. 최근 사용한 국가는 한 번의 클릭으로 선택할 수 있습니다.
- **Region**, **City**, **Network operator:** 국가를 선택한 후 사용할 수 있는 Premium 전용 옵션입니다.
- **Address:** **Keep one**은 동일한 출구를 유지하고, **New every request**는 매 요청마다 변경하며, **New address**는 지금 즉시 새 주소를 할당받습니다. Premium에서 **Keep one**을 선택한 경우, **Hold it for**를 통해 주소 유지 시간을 분 또는 시간 단위로 설정합니다.

이러한 선택 항목의 기본 스위치는 [Proxy Port](https://foura.ai/docs/api/proxy-port) 문서에 설명된 proxy port 설정과 동일합니다.

### 설정

- **What goes through the tunnel:** 목록을 제외한 모든 항목인 **Everything except** 또는 지정 목록만 통과하는 **Only these**입니다. `example.com`은 서브도메인을 포함하며, `*`는 와일드카드로 작동하고, `203.0.113.0/24`는 대역을 의미합니다.
- **Never tunnel the local network or this machine:** 점(.)이 없는 이름, `localhost`, `.local` 및 사설 IP 대역은 목록 설정과 관계없이 항상 로컬 연결을 유지합니다.
- **Let plain http:// pages use my own connection:** proxy port는 암호화된 연결만 처리합니다. 비활성화 시 일반 `http://` 페이지는 로드되지 않습니다. 활성화 시 로컬 연결을 통해 로드되며 사이트에 실제 주소가 노출됩니다.
- **Stop WebRTC from finding a way around the proxy:** 터널이 켜져 있는 동안 페이지가 실제 주소를 조회할 수 있는 경로를 차단합니다.
- **Incognito windows:** 시크릿 창도 터널을 사용합니다. `chrome://extensions`, FourA, **Details**, **Allow in Incognito**에서 권한을 허용해야만 FourA가 해당 창에서 proxy 패스워드를 자동으로 입력할 수 있습니다. 허용하기 전까지는 Chrome이 시크릿 창에서 패스워드를 직접 묻습니다.
- **Theme:** 팝업에 적용할 **System**, **Light**, **Dark** 테마입니다.
- **Proxy address for other tools:** 프록시를 지원하는 모든 클라이언트에 붙여넣을 수 있도록 선택된 proxy user와 패스워드가 포함된 proxy URL입니다. 패스워드처럼 안전하게 다루어야 합니다.
- **Proxy users:** **Reload from dashboard**는 생성하거나 수정한 proxy user를 동기화합니다. **Forget on this computer**는 이 브라우저에서 해당 사용자를 삭제합니다.

### 아이콘이 빨간색으로 변할 때

숫자가 적힌 빨간색 아이콘은 지난 1분 동안 proxy가 해당 횟수만큼 연결을 거부했음을 의미합니다. 이유를 확인하려면 FourA를 여십시오. 가장 흔한 원인은 다음과 같습니다.

- **Too many connections at once:** 요금제의 열린 터널 수 한도입니다. 연결이 닫히면 페이지의 일부가 다시 로드됩니다.
- **Too many new connections this minute:** 요금제의 분당 신규 터널 수 한도입니다. 모든 재시도도 횟수에 포함되므로 1분 정도 기다린 후 다시 로드하십시오.
- **This period's proxy traffic is used up** 또는 **Premium traffic is used up:** **Billing** 페이지에서 트래픽을 추가하거나 다음 결제 주기를 기다리십시오.
- **The proxy is not in your plan:** **Billing** 페이지에서 요금제를 확인하십시오.
- **The proxy did not accept the password:** 대시보드에서 프록시 사용자가 교체되었거나 삭제되었을 수 있습니다. 다시 선택하십시오.
- **Another extension controls the proxy:** 다른 확장 프로그램이 Chrome의 프록시 설정을 제어하는 동안에는 FourA가 아무것도 라우팅하지 않습니다. 해당 확장 프로그램을 끈 다음 스위치를 껐다 켜십시오.

요금제의 현재 한도는 [Usage & Limits](https://foura.ai/docs/dashboard/quota) 페이지에서 확인할 수 있습니다.

## 요청을 API 호출로 변환하기

1. 아무 페이지에서나 DevTools를 열고 Network 옆에 있는 **FourA** 탭(DevTools 창이 좁을 때는 `»` 뒤에 숨겨짐)을 선택합니다. FourA를 설치할 때 DevTools가 열려 있었다면 닫았다가 다시 여십시오.
2. 페이지를 다시 로드합니다. 이 탭은 Network처럼 페이지의 요청 목록을 표시합니다. **Hide ads and analytics**는 기본적으로 켜져 있으며, **This site only**는 해당 페이지 자체의 요청만 유지합니다.
3. 페이지에 표시된 텍스트를 **Find in responses**에 입력하여 해당 텍스트가 포함된 요청을 찾습니다. 요청을 선택하여 **Headers**, **Payload**, **Response**를 확인하십시오.
4. **FourA call**에서 엔진(Single, Proxy Finder 또는 Browser)을 선택하고, Proxy Finder의 경우 선택적으로 **Exit country**를 지정한 다음 호출을 curl, Python, Node 또는 MCP 형태로 복사합니다. 이 호출에는 페이지에서 사용한 헤더와 쿠키가 포함됩니다. **Present the same browser and system as this window**는 기본적으로 켜져 있습니다. 이 호출은 현재 Chrome과 일치하는 브라우저 프로필을 요청하거나, Browser 엔진의 경우 현재 창의 User-Agent를 전송합니다.
5. **Open in the playground**를 클릭하여 대시보드 [Playground](https://foura.ai/docs/dashboard/playground)에서 호출을 로드하거나, **Run through FourA**를 클릭하여 실행합니다. 실행 후 **The browser got**과 **FourA got**에 페이지의 응답과 FourA의 응답이 나란히 표시됩니다.

요청을 마우스 우클릭하면 동일한 복사 옵션 외에도 **Copy URL**, **Copy response**, **Open in a new tab**을 사용할 수 있습니다.

### 실행을 위한 API Key

**Run through FourA**는 API key와 해당 크레딧을 사용합니다. 탭의 **Settings**에서 설정하십시오.

1. **Choose from your dashboard**를 클릭하고 키를 선택하거나, **Or paste an API key**에 키를 붙여넣습니다.
2. Chrome이 종료된 후에도 키를 유지하려면 **Keep the key on this computer**를 선택합니다. 그렇지 않으면 Chrome이 닫힐 때까지만 유지됩니다.
3. **Forget the key**를 누르면 키가 삭제됩니다.

해당 키가 본인의 계정에 속한 경우 Playground는 동일한 키가 선택된 상태로 열립니다. 그렇지 않은 경우 키를 선택하라는 메시지가 표시됩니다.

## 비용 안내

확장 프로그램은 무료입니다. 해당 프로그램이 당사 출구를 통해 전송하는 트래픽은 proxy 포트의 다른 클라이언트와 마찬가지로 요금제의 proxy 허용량에서 차감됩니다. DevTools에서 실행하는 호출에는 API 요금이 부과됩니다. [요금제 및 측정](https://foura.ai/docs/guides/plans-and-metering)을 참고하십시오.

## 저장 및 전송되는 정보

- 선택한 proxy 사용자와 비밀번호는 이 컴퓨터에만 유지됩니다.
- DevTools 탭에서 선택한 API key는 Chrome이 닫힐 때까지 유지되거나, 사용자가 요청한 경우 이 컴퓨터에 유지됩니다.
- 방문한 페이지에 대한 정보는 저장되거나 당사로 전송되지 않습니다.
- 확장 프로그램은 자체적으로 사이트가 확인하는 주소를 파악하기 위해 ipinfo.io(해당 서비스가 사용 중일 때는 Cloudflare 및 api.ipify.org)에 요청하고, 1시간마다 및 확장 프로그램을 열 때 최신 버전을 확인하기 위해 foura.ai에 요청하며, 대시보드에서 proxy 사용자 및 국가 목록을 읽어오고, dns.google 또는 Cloudflare에서 proxy 주소를 조회합니다. 그 외의 모든 작업은 버튼을 누를 때 실행됩니다.
- cookie와 함께 복사된 호출은 로그인된 세션을 재현합니다. 비밀번호처럼 취급하고 공개된 장소에 붙여넣지 마십시오.
- 스위치가 켜진 상태에서 설정을 변경하면 FourA는 새로운 설정이 proxy에 적용되도록 Chrome에 저장된 proxy 자격 증명을 삭제합니다. 이 삭제는 proxy 자체의 주소에만 적용되며, cookie와 대시보드 로그인 상태는 유지됩니다.

## 제한 사항

- 브라우저는 터널을 통해 자체 암호화 연결을 생성하므로 사이트는 당사 주소와 사용자의 브라우저를 확인하게 됩니다. 요청자를 확인하는 페이지 및 전체 브라우저 렌더링은 API에서 처리됩니다. [사이트 확인](https://foura.ai/docs/api/site-checks)을 참고하십시오.
- 이 확장 프로그램은 Chrome 전용으로 빌드되고 테스트되었습니다.
