# Rozszerzenie Chrome (Beta)

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

Rozszerzenie FourA dla Chrome dodaje dwa narzędzia do Twojej przeglądarki. **Popup** przekierowuje ruch Chrome przez jednego z Twoich użytkowników proxy na [porcie proxy](https://foura.ai/docs/api/proxy-port). **Karta FourA w DevTools** zamienia dowolne żądanie wysyłane przez stronę w gotowe wywołanie API.

Rozszerzenie jest w wersji beta. Nie ma go jeszcze w Chrome Web Store, więc Chrome instaluje je w trybie deweloperskim, a jego ekrany i ustawienia mogą jeszcze ulec zmianie. Wymaga Chrome w wersji 116 lub nowszej i działa na każdym planie, w tym na planie Free.

## Instalacja

Plik zip znajduje się w panelu: otwórz **Rozszerzenie** w sekcji **Narzędzia** na pasku bocznym i kliknij **Pobierz**.

1. Pobierz plik zip i go rozpakuj. Zachowaj ten folder: Chrome ładuje rozszerzenie bezpośrednio z niego.
2. Otwórz `chrome://extensions` i włącz **Tryb programisty** w prawym górnym rogu.
3. Kliknij **Załaduj rozpakowane** i wybierz rozpakowany folder.
4. Przypnij FourA za pomocą ikony puzzla na pasku narzędzi. Ikona jest szara, gdy FourA jest wyłączone, a podczas przekierowywania ruchu wyświetla zieloną kropkę.

### Aktualizacje

Rozszerzenie sprawdza dostępność nowej wersji raz na godzinę oraz przy każdym otwarciu okna popup. Opcja **Sprawdź teraz** w sekcji **Wersja** w ustawieniach pozwala sprawdzić to natychmiast. Gdy nowa wersja jest dostępna, popup wyświetla jej numer wraz z przyciskiem **Pobierz**. Rozpakuj nową wersję i wybierz jej folder za pomocą przycisku **Załaduj rozpakowane**. FourA automatycznie zastąpi poprzednią wersję i zachowa Twoje ustawienia, niezależnie od ścieżki nowego folderu. Jeśli pliki zostały rozpakowane bezpośrednio do bieżącego folderu, wystarczy kliknąć **Przeładuj FourA**. W przypadku aktualizacji z wersji 0.3.1 lub starszej rozszerzenie zainstaluje się jako nowa karta: wybierz ponownie swojego użytkownika proxy i usuń starą kartę.

## Zanim zaczniesz

- Użytkownik proxy. Utwórz go na stronie **Proxy** w panelu: zobacz [Proxy](https://foura.ai/docs/dashboard/proxy).
- Zalogowany panel w tej samej przeglądarce Chrome. Rozszerzenie odczytuje listę użytkowników proxy wyłącznie z panelu. Jeśli żadna karta panelu nie jest otwarta, rozszerzenie otworzy ją w tle, aby pobrać dane, po czym ją zamknie.

## Przeglądanie przez FourA

Popup zawiera trzy zakładki: **Połącz**, **Lokalizacja** i **Ustawienia**.

### Połącz

1. Otwórz FourA z paska narzędzi i wybierz użytkownika proxy, z którego ma korzystać ta przeglądarka.
2. Kliknij główny przełącznik.
3. Sprawdź pole **Adres widoczny dla stron**. FourA weryfikuje ten adres bezpośrednio przez tunel zamiast zakładać jego wartość na podstawie ustawień, i wyświetla obok **Twój adres** w celach porównawczych.

Pole **Ruch w tym okresie** pokazuje, ile transferu proxy z Twojego planu zostało już zużyte.

### Lokalizacja

- **Sieć:** **Współdzielona** (nasza pula, transfer z planu) lub **Premium** (adresy domowe, pobierane z transferu premium Twojego planu). W sieci współdzielonej opcja **Użyj premium, gdy współdzielona nie może załadować strony** wybiera wyjście premium, gdy sieć współdzielona nie może obsłużyć żądania. Działa to tylko wtedy, gdy Twój plan obejmuje transfer premium i pozostał jeszcze limit.
- **Kraj:** domyślnie dowolny kraj. Kraje używane ostatnio są dostępne za jednym kliknięciem.
- **Region**, **Miasto** i **Operator sieci:** tylko w premium, po wybraniu kraju.
- **Adres:** **Zachowaj jeden** utrzymuje ten sam węzeł wyjściowy, **Nowy przy każdym żądaniu** zmienia go przy każdym żądaniu, a **Nowy adres** pobiera nowy natychmiast. W premium z opcją **Zachowaj jeden**, pole **Utrzymuj przez** określa, jak długo adres jest zachowywany, w minutach lub godzinach.

Przełączniki stojące za tymi opcjami są dokładnie tymi samymi, które port proxy opisuje w dokumencie [Port proxy](https://foura.ai/docs/api/proxy-port).

### Ustawienia

- **Co przechodzi przez tunel:** **Wszystko oprócz** listy lub **Tylko wybrane**. `example.com` obejmuje swoje subdomeny, `*` działa jako symbol wieloznaczny, a `203.0.113.0/24` to zakres.
- **Nigdy nie tuneluj sieci lokalnej ani tej maszyny:** nazwy bez kropki, `localhost`, `.local` oraz prywatne zakresy adresów pozostają na Twoim własnym połączeniu, niezależnie od zawartości listy.
- **Pozwól zwykłym stronom http:// korzystać z mojego połączenia:** port proxy obsługuje wyłącznie połączenia szyfrowane. Gdy opcja jest wyłączona, zwykła strona `http://` nie ładuje się. Gdy jest włączona, ładuje się przez Twoje własne połączenie, a witryna widzi Twój adres.
- **Zablokuj WebRTC przed omijaniem proxy:** zamyka ścieżkę, którą strona może wykorzystać do odczytania Twojego prawdziwego adresu przy włączonym tunelu.
- **Okna incognito:** one również korzystają z tunelu. FourA może podać tam hasło proxy tylko wtedy, gdy na to zezwolisz: `chrome://extensions`, FourA, **Szczegóły**, **Zezwalaj w trybie incognito**. Do tego momentu Chrome pyta o hasło w trybie incognito.
- **Motyw:** **Systemowy**, **Jasny** lub **Ciemny** dla wyskakującego okna.
- **Adres proxy dla innych narzędzi:** wybrany użytkownik proxy w postaci proxy URL, wraz z hasłem, do wklejenia do dowolnego klienta, który go obsługuje. Traktuj go jak hasło.
- **Użytkownicy proxy:** **Odśwież z panelu** pobiera utworzonych lub zmodyfikowanych użytkowników proxy. **Zapomnij na tym komputerze** usuwa ich z tej przeglądarki.

### Gdy ikona zmieni kolor na czerwony

Czerwona ikona z liczbą oznacza, że proxy odrzuciło tyle połączeń w ciągu ostatniej minuty. Otwórz FourA, aby sprawdzić przyczynę. Najczęstsze powody:

- **Zbyt wiele połączeń naraz:** limit otwartych tuneli w Twoim planie. Elementy strony załadują się ponownie po zamknięciu połączeń.
- **Zbyt wiele nowych połączeń w tej minucie:** limit nowych tuneli na minutę w Twoim planie. Odczekaj minutę przed ponownym załadowaniem, ponieważ każda próba również się wlicza.
- **Wykorzystano transfer proxy w tym okresie** lub **Wykorzystano transfer Premium:** dokup transfer na stronie **Billing** lub poczekaj na kolejny okres.
- **Proxy nie jest zawarte w Twoim planie:** sprawdź plany na stronie **Billing**.
- **Proxy nie zaakceptowało hasła:** użytkownik proxy mógł zostać zmieniony lub usunięty w panelu. Wybierz go ponownie.
- **Inne rozszerzenie kontroluje proxy:** dopóki inne rozszerzenie zarządza ustawieniami proxy w Chrome, FourA niczego nie przekierowuje. Wyłącz to rozszerzenie, a następnie wyłącz i włącz przełącznik.

Aktualne limity Twojego planu znajdują się na stronie [Usage & Limits](https://foura.ai/docs/dashboard/quota).

## Przekształcanie żądania w wywołanie API

1. Otwórz DevTools na dowolnej stronie i wybierz kartę **FourA**, obok Network (za `»`, gdy okno DevTools jest wąskie). Jeśli DevTools było otwarte podczas instalacji FourA, zamknij je i otwórz ponownie.
2. Odśwież stronę. Karta wyświetla listę żądań strony tak jak Network. Opcja **Hide ads and analytics** jest domyślnie włączona, a **This site only** zachowuje tylko własne żądania strony.
3. Wpisz tekst widoczny na stronie w polu **Find in responses**, aby znaleźć żądanie, które go zawiera. Wybierz żądanie, aby zobaczyć jego **Headers**, **Payload** i **Response**.
4. W sekcji **FourA call** wybierz silnik (Single, Proxy Finder lub Browser) oraz, dla Proxy Finder, opcjonalny **Exit country**, a następnie skopiuj wywołanie jako cURL, Python, Node lub MCP. Wywołanie przenosi nagłówki i pliki cookie używane przez stronę. Opcja **Present the same browser and system as this window** jest domyślnie włączona: wywołanie prosi o profil przeglądarki zgodny z tą instancją Chrome lub w przypadku Browser wysyła User-Agent tego okna.
5. Kliknij **Open in the playground**, aby załadować wywołanie w [Playground](https://foura.ai/docs/dashboard/playground) w panelu, lub **Run through FourA**, aby je uruchomić. Po wykonaniu **The browser got** oraz **FourA got** pokazują odpowiedź strony i naszą obok siebie.

Kliknięcie żądania prawym przyciskiem myszy oferuje te same opcje kopiowania oraz **Copy URL**, **Copy response** i **Open in a new tab**.

### Klucz API do uruchomień

Funkcja **Run through FourA** korzysta z klucza API i jego środków. Ustaw go w sekcji **Settings** na karcie:

1. Kliknij **Choose from your dashboard** i wybierz klucz lub wklej go w polu **Or paste an API key**.
2. Zaznacz **Keep the key on this computer**, aby zachować go po zamknięciu Chrome. W przeciwnym razie pozostaje aktywny do momentu zamknięcia Chrome.
3. Opcja **Forget the key** usuwa go.

Playground otwiera się z wybranym tym samym kluczem, jeśli należy on do Twojego konta. W przeciwnym razie poprosi o wybranie klucza.

## Koszty

Rozszerzenie jest bezpłatne. Ruch przesyłany przez nasze węzły wyjściowe wlicza się do limitu proxy w Twoim planie, tak samo jak w przypadku każdego innego klienta na porcie proxy. Wywołania uruchamiane z DevTools kosztują tyle, ile nalicza API. Zobacz [Plany i rozliczenia](https://foura.ai/docs/guides/plans-and-metering).

## Co jest przechowywane i wysyłane

- Wybrany użytkownik proxy i jego hasło pozostają na tym komputerze.
- Klucz API wybrany w karcie DevTools pozostaje do momentu zamknięcia Chrome lub na tym komputerze, jeśli tak wybierzesz.
- Żadne informacje o odwiedzanych stronach nie są przechowywane ani wysyłane do nas.
- Samodzielnie rozszerzenie odpytuje ipinfo.io (lub Cloudflare, a następnie api.ipify.org, gdy ten pierwszy jest zajęty), jaki adres widzi strona, sprawdza na foura.ai raz na godzinę oraz przy otwarciu aktualną wersję, pobiera listę użytkowników proxy i krajów z Twojego panelu oraz sprawdza adres proxy przez dns.google lub Cloudflare. Wszystko inne dzieje się tylko po kliknięciu przycisku.
- Wywołanie skopiowane z plikami cookie odtwarza sesję, do której jesteś zalogowany. Traktuj je jak hasło i nie wklejaj w publicznych miejscach.
- Gdy zmieniasz ustawienie przy włączonym przełączniku, FourA czyści zapisane w Chrome dane uwierzytelniające proxy, aby nowy wybór dotarł do proxy. Czyszczenie dotyczy wyłącznie adresu samego proxy: pliki cookie pozostają nienaruszone, podobnie jak logowanie do panelu.

## Ograniczenia

- Twoja przeglądarka tworzy własne szyfrowane połączenie przez tunel, więc strona widzi nasz adres i Twoją przeglądarkę. Strony sprawdzające klienta oraz pełne renderowanie w przeglądarce są obsługiwane przez API: zobacz [Weryfikacja stron](https://foura.ai/docs/api/site-checks).
- Chrome jest jedyną przeglądarką, dla której rozszerzenie jest budowane i testowane.
