Chrome 확장 프로그램 (베타)
FourA Chrome 확장 프로그램은 브라우저에 두 가지 도구를 제공합니다. 팝업은 proxy 포트에서 Chrome 트래픽을 proxy 사용자 중 하나를 통해 라우팅합니다. DevTools의 FourA 탭은 페이지의 모든 request를 바로 사용 가능한 API 호출로 변환합니다.
이 확장 프로그램은 베타 버전입니다. 아직 Chrome 웹 스토어에 등록되지 않아 Chrome 개발자 모드로 설치해야 하며, 화면 구성과 설정은 변경될 수 있습니다. Chrome 116 이상 버전이 필요하며 Free 플랜을 포함한 모든 플랜에서 작동합니다.
설치
zip 파일은 대시보드에 있습니다. 사이드바의 도구 아래에서 확장 프로그램을 열고 다운로드를 클릭하세요.
- zip 파일을 다운로드하고 압축을 풉니다. 압축을 푼 폴더는 그대로 유지하세요. Chrome이 해당 폴더에서 확장 프로그램을 로드합니다.
chrome://extensions를 열고 오른쪽 상단의 개발자 모드를 켭니다.- 압축해제된 확장 프로그램을 로드합니다를 클릭하고 압축을 푼 폴더를 선택합니다.
- 툴바의 퍼즐 아이콘에서 FourA를 고정합니다. FourA가 꺼져 있을 때는 아이콘이 회색이고, 라우팅 중일 때는 녹색 점이 표시됩니다.
업데이트
확장 프로그램은 1시간마다 한 번씩, 그리고 팝업을 열 때마다 새 버전을 확인합니다. 팝업 설정의 버전 아래에 있는 지금 확인을 누르면 즉시 확인합니다. 새 버전이 출시되면 팝업에 버전 정보와 함께 다운로드 버튼이 표시됩니다. 새 버전의 압축을 풀고 압축해제된 확장 프로그램을 로드합니다로 해당 폴더를 선택하세요. 새 버전 폴더 위치와 관계없이 FourA가 기존 설정을 유지한 채 업데이트됩니다. 현재 폴더 위에 압축을 풀었다면 FourA 다시 로드만으로 충분합니다. 0.3.1 이하 버전에서 업데이트하는 경우 새 카드로 한 번 설치됩니다. proxy 사용자를 다시 선택하고 기존 카드를 삭제하세요.
시작하기 전에
- proxy 사용자가 필요합니다. 대시보드의 Proxy 페이지에서 생성하세요. Proxy를 참조하세요.
- 동일한 Chrome 브라우저에서 대시보드에 로그인되어 있어야 합니다. 확장 프로그램은 대시보드에서만 proxy 사용자를 읽어옵니다. 열려 있는 대시보드 탭이 없으면 백그라운드에서 탭을 열어 정보를 읽은 후 다시 닫습니다.
FourA를 통해 탐색
팝업에는 연결, 위치, 설정 세 페이지가 있습니다.
연결
- 툴바에서 FourA를 열고 이 브라우저에서 사용할 proxy 사용자를 선택합니다.
- 큰 스위치를 누릅니다.
- 사이트에 표시되는 주소를 확인합니다. 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 문서에 설명된 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 페이지에서 확인할 수 있습니다.
요청을 API 호출로 변환하기
- 아무 페이지에서나 DevTools를 열고 Network 옆에 있는 FourA 탭(DevTools 창이 좁을 때는
»뒤에 숨겨짐)을 선택합니다. FourA를 설치할 때 DevTools가 열려 있었다면 닫았다가 다시 여십시오. - 페이지를 다시 로드합니다. 이 탭은 Network처럼 페이지의 요청 목록을 표시합니다. Hide ads and analytics는 기본적으로 켜져 있으며, This site only는 해당 페이지 자체의 요청만 유지합니다.
- 페이지에 표시된 텍스트를 Find in responses에 입력하여 해당 텍스트가 포함된 요청을 찾습니다. 요청을 선택하여 Headers, Payload, Response를 확인하십시오.
- 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를 전송합니다.
- Open in the playground를 클릭하여 대시보드 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에서 설정하십시오.
- Choose from your dashboard를 클릭하고 키를 선택하거나, Or paste an API key에 키를 붙여넣습니다.
- Chrome이 종료된 후에도 키를 유지하려면 Keep the key on this computer를 선택합니다. 그렇지 않으면 Chrome이 닫힐 때까지만 유지됩니다.
- Forget the key를 누르면 키가 삭제됩니다.
해당 키가 본인의 계정에 속한 경우 Playground는 동일한 키가 선택된 상태로 열립니다. 그렇지 않은 경우 키를 선택하라는 메시지가 표시됩니다.
비용 안내
확장 프로그램은 무료입니다. 해당 프로그램이 당사 출구를 통해 전송하는 트래픽은 proxy 포트의 다른 클라이언트와 마찬가지로 요금제의 proxy 허용량에서 차감됩니다. DevTools에서 실행하는 호출에는 API 요금이 부과됩니다. 요금제 및 측정을 참고하십시오.
저장 및 전송되는 정보
- 선택한 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에서 처리됩니다. 사이트 확인을 참고하십시오.
- 이 확장 프로그램은 Chrome 전용으로 빌드되고 테스트되었습니다.