Расширение Chrome (Beta)
Расширение FourA для Chrome добавляет в ваш браузер два инструмента. Popup направляет трафик Chrome через одного из ваших proxy-пользователей на порту proxy. Вкладка FourA в DevTools превращает любой запрос со страницы в готовый API-вызов.
Расширение находится в статусе бета-версии. Его пока нет в Chrome Web Store, поэтому Chrome устанавливает его в режиме разработчика, а экраны и настройки еще могут меняться. Требуется Chrome версии 116 или новее, расширение работает на любом тарифе, включая бесплатный Free.
Установка
Zip-архив находится в панели управления: откройте Extension в разделе Tools на боковой панели и нажмите Download.
- Скачайте zip-архив и распакуйте его. Сохраните папку: Chrome загружает расширение из нее.
- Откройте
chrome://extensionsи включите Режим разработчика в правом верхнем углу. - Нажмите Загрузить распакованное расширение и выберите распакованную папку.
- Закрепите FourA с помощью значка пазла на панели инструментов. Значок остается серым, пока FourA выключен, и показывает зеленую точку во время маршрутизации.
Обновления
Расширение проверяет наличие новой версии раз в час и при открытии popup, а кнопка Check now в разделе Version настроек popup запускает проверку немедленно. Когда выходит новая версия, в popup отображается номер версии с кнопкой Download. Распакуйте новую версию и выберите ее папку через Загрузить распакованное расширение. FourA обновится и сохранит ваши настройки независимо от папки с новой версией. Если вы распаковали ее поверх текущей папки, достаточно нажать Reload FourA. При переходе с версии 0.3.1 или старее расширение установится как новая карточка: выберите proxy-пользователя заново и удалите старую карточку.
Перед началом работы
- Proxy-пользователь. Создайте его на странице Proxy в панели управления: см. Proxy.
- Выполненный вход в панель управления в том же браузере Chrome. Расширение считывает ваших proxy-пользователей только из панели управления. Если вкладка панели не открыта, оно открывает ее в фоновом режиме для чтения данных и затем закрывает.
Работа в браузере через FourA
В popup есть три раздела: Connect, Location и Settings.
Connect
- Откройте FourA на панели инструментов и выберите proxy-пользователя для этого браузера.
- Нажмите большой переключатель.
- Посмотрите значение Address sites see. FourA определяет этот адрес непосредственно через туннель, а не берет его из настроек, и показывает рядом Your address для сравнения.
Параметр Traffic this period показывает, сколько proxy-трафика из вашего тарифа вы израсходовали.
Location
- Сеть: Shared (наш пул, трафик по тарифу) или Premium (резидентские, оплата за ГБ). В Shared опция Use premium when shared cannot carry a page переключает на premium-выход, если сеть shared не может обработать запрос. Она срабатывает, только если ваш тариф включает premium-трафик и остался лимит.
- Страна: любая страна по умолчанию. Недавно использованные страны доступны в один клик.
- Регион, Город и Оператор связи: только для premium, после выбора страны.
- Адрес: Keep one сохраняет тот же выходной узел, New every request меняет его при каждом запросе, а New address переключает на новый прямо сейчас. В premium с опцией Keep one параметр Hold it for задает время удержания адреса в минутах или часах.
Параметры этих настроек совпадают с теми, что описаны в документации по порту прокси в Proxy Port.
Настройки
- Что направлять через туннель: Everything except (все, кроме списка) или Only these (только указанные).
example.comохватывает свои поддомены,*работает как маска, а203.0.113.0/24задает диапазон. - Никогда не направлять локальную сеть или этот компьютер в туннель: имена без точек,
localhost,.localи диапазоны частных адресов всегда идут через ваше прямое соединение, независимо от списка. - Разрешить обычным http:// страницам использовать прямое соединение: порт прокси пропускает только зашифрованные соединения. Если опция выключена, обычная страница
http://не загрузится. Если включена, она загружается через ваше прямое соединение, и сайт видит ваш реальный адрес. - Запретить WebRTC обходить прокси: блокирует возможность страницы определить ваш реальный адрес при активном туннеле.
- Окна в режиме инкогнито: они тоже используют туннель. FourA может передавать пароль прокси в инкогнито, только если вы разрешите это:
chrome://extensions, FourA, Details, Allow in Incognito. До этого момента Chrome будет запрашивать пароль вручную в режиме инкогнито. - Адрес прокси для других инструментов: выбранный пользователь прокси в формате proxy URL вместе с паролем для вставки в любой клиент. Относитесь к нему как к паролю.
- Пользователи прокси: Reload from dashboard подтягивает созданных или измененных пользователей прокси. Forget on this computer удаляет их из этого браузера.
Если иконка становится красной
Красная иконка с числом означает, что прокси отклонил указанное количество соединений за последнюю минуту. Откройте FourA, чтобы узнать причину. Самые частые причины:
- Too many connections at once: лимит вашего тарифа на открытые туннели. Части страницы загружаются снова по мере закрытия соединений.
- Too many new connections this minute: лимит вашего тарифа на новые туннели в минуту. Подождите минуту перед повторной загрузкой, так как каждая попытка тоже учитывается.
- 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: возможно, пользователь proxy был сменен или удален в dashboard. Выберите его снова.
- Another extension controls the proxy: пока другое расширение управляет настройками proxy в Chrome, FourA ничего не маршрутизирует. Отключите это расширение, затем выключите и снова включите переключатель.
Текущие лимиты вашего тарифа указаны на странице Usage & Limits.
Turn a Request Into an API Call
- Откройте DevTools на любой странице и выберите вкладку FourA рядом с Network (скрыта за
», если окно DevTools узкое). Если DevTools были открыты во время установки FourA, закройте и откройте их снова. - Перезагрузите страницу. Во вкладке отобразится список запросов страницы, аналогично вкладке Network. Опция Hide ads and analytics включена по умолчанию, а This site only оставляет только собственные запросы страницы.
- Введите текст, который вы видите на странице, в поле Find in responses, чтобы найти содержащий его запрос. Выберите запрос, чтобы просмотреть его Headers, Payload и Response.
- В блоке FourA call выберите движок (Single, Proxy Finder или Browser) и опционально Exit country, затем скопируйте вызов в формате curl, Python, Node или MCP. Вызов содержит header и cookie, использованные страницей.
- Нажмите Open in the playground, чтобы загрузить вызов в Playground в dashboard, или Run through FourA, чтобы выполнить его. После выполнения блоки The browser got и FourA got покажут ответ страницы и наш ответ рядом друг с другом.
Клик правой кнопкой мыши по запросу предлагает те же варианты копирования, а также Copy URL, Copy response и Open in a new tab.
The API Key for Runs
Кнопка Run through FourA использует API key и его кредиты. Настройте его в Settings вкладки:
- Нажмите Choose from your dashboard и выберите ключ, или вставьте его в поле Or paste an API key.
- Отметьте Keep the key on this computer, чтобы сохранить его после закрытия Chrome. В противном случае он сохранится только до закрытия Chrome.
- Кнопка Forget the key удаляет его.
Playground открывается с тем же выбранным ключом, если этот ключ принадлежит вашему аккаунту. В противном случае вам будет предложено выбрать ключ.
What It Costs
Расширение бесплатно. Трафик, который оно отправляет через наши выходные узлы, расходует лимит proxy вашего тарифа так же, как и любой другой клиент на proxy-порту. Запросы, запускаемые из DevTools, тарифицируются согласно ценам API. См. Plans and Metering.
What It Stores and Sends
- Выбранный пользователь proxy и его пароль остаются на этом компьютере.
- Ключ API, выбранный на вкладке DevTools, сохраняется до закрытия Chrome или на этом компьютере по вашему запросу.
- Никакая информация о посещаемых вами страницах не сохраняется и не передается нам.
- Самостоятельно расширение запрашивает у ipinfo.io (или у Cloudflare, а затем у api.ipify.org, если сервис недоступен), какой адрес видит сайт, запрашивает у foura.ai раз в час и при открытии актуальную версию, считывает ваших proxy пользователей и список стран из панели управления, а также определяет адрес proxy через dns.google или Cloudflare. Все остальные действия выполняются только по нажатию кнопки.
- Запрос, скопированный с cookies, воспроизводит текущую авторизованную сессию. Обращайтесь с ним как с паролем и не публикуйте его в открытом доступе.
Limits
- Браузер создает собственное зашифрованное соединение через туннель, поэтому сайт видит наш адрес и ваш браузер. Страницы, проверяющие источник запроса, и полноценный рендеринг браузера обрабатываются через API: см. Site checks.
- Chrome является единственным браузером, для которого создано и протестировано расширение.