Cloudflare Turnstile
widżet- Gdzie to widzisz
- Widget wewnątrz strony lub formularza
- Co zwraca
- Token w
cf-turnstile-response - strona CapMonstera
- Ta strona: Cloudflare Turnstile Solver
Ostatnia aktualizacja:
Widżet Cloudflare Challenge i Turnstile mogą wyglądać tak samo. Wyzwanie nie zawsze jest osobną stroną „Chwileczkę…”: można je stylizować, osadzić w witrynie lub sprawić, by wyglądało jak zwykły widżet Turnstile, więc nie można ich odróżnić po wyglądzie.
cf-turnstile-responsechallenge-form z __cf_chl_f_tk=cf_clearanceW tabeli podano cenę, czas rozwiązania i wskaźnik powodzenia rozwiązania dla czterech usług rozwiązywania problemów Cloudflare Turnstile.
| Parametr | CapMonster Cloud | 2Captcha | Anti-Captcha | DeathByCaptcha |
|---|---|---|---|---|
Cena za 1000 rozwiązań (od) | $ 1.30 | — | — | — |
Czas rozwiązać | 6,24 s* | 16,9 sek | 20,33 sek | ~13 s |
Wskaźnik sukcesu rozwiązania | 99%* | 96% | 96% | 96% |
2Captcha, Anti-Captcha i DeathByCaptcha są znakami towarowymi odpowiednich właścicieli. CapMonster Cloud nie jest powiązany z tymi podmiotami. Wskaźniki wydajności i porównania cen opierają się na publicznie dostępnych danych i wewnętrznych testach porównawczych na dzień 02.10.2026.
Już teraz przetestuj stabilność na swoich własnych stronach docelowych. Nie gwarantujemy 100% skuteczności: typy CAPTCHA i konfiguracja witryny docelowej mogą ulec zmianie w dowolnym momencie.
$0.10
Nowi użytkownicy otrzymują 0,10 $ salda testowego, aby wypróbować CapMonster Cloud.
1. Zarejestruj się pod numerem CapMonster Cloud.
2. Wyślij wiadomość do pomocy przez czat na żywo lub support@capmonster.cloud, podając adres e-mail powiązany z Twoim kontem.
Uruchom rejestrację, realizację transakcji i przepływy formularzy w CI/CD z Playwright, Puppeteer lub Selenium na stronach, które posiadasz lub które możesz testować.
Sprawdź, czy chronione formularze i punkty końcowe nadal działają po wydaniach i zmianach widżetów.
Zbieraj publicznie dostępne dane z otwartych stron, które używają Cloudflare Turnstile.
Obsługuj zautomatyzowane, pomocnicze przepływy pracy w witrynach, które opierają się na kontrolach botów invisible.
Pozwól agentowi zażądać tokena poprzez MCP, gdy przepływ pracy osiągnie captcha.
Użyj CapMonster Cloud w przypadku publicznie dostępnych danych oraz w witrynach, których jesteś właścicielem lub do których testowania jesteś upoważniony. Zbieranie danych osób trzecich za loginem lub zaporą płatniczą bez pozwolenia jest zabronione.
Cloudflare Turnstile weryfikuje odwiedzających za pomocą sygnałów przeglądarki po stronie klienta i oceny ryzyka zamiast zagadek obrazkowych. Jest dostępny w trzech trybach widżetów: Managed (zalecane), Non-Interactive i Invisible. CapMonster Cloud obsługuje je wszystkie automatycznie — nigdy nie określasz trybu w zadaniu.
Źródła: Cloudflare dokumentacja — Typy widżetów · Rozpocznij · Turnstile w Cloudflare wyzwaniach
Turnstile automatycznie wybiera pomiędzy zaznaczeniem non-interactive a polem wyboru w oparciu o poziom ryzyka odwiedzającego. Brak obrazów i tekstu do rozszyfrowania.
Widoczny widget ze spinnerem ładującym. Kontrola odbywa się bez interakcji z odwiedzającym.
Kontrola przebiega całkowicie w tle: nie jest wyświetlany żaden widżet ani wskaźnik ładowania.
Strona ładuje kod inicjujący widget; Cloudflare zwraca wymagany JS i wyświetla się widget.
Na podstawie trybu widżetu i sygnałów ryzyka Cloudflare widżet decyduje, czy wyświetlić interaktywne wyzwanie.
Po stronie klienta callback otrzymuje token — jednorazowy, ważny przez 300 sekund. Jeśli widżet znajduje się w polu <form>, token jest również dodawany automatycznie jako ukryte pole cf-turnstile-response.
Strona wysyła token do backendu z danymi formularza.
Twój serwer wywołuje numer Cloudflare Siteverify API, aby potwierdzić token.
Źródła: Cloudflare dokumentacja — Osadź widżet · Zatwierdź token
Token Turnstile to ciąg znaków generowany przez widget po zweryfikowaniu odwiedzającego. Widżet przechowuje go w ukrytym polu formularza o nazwie cf-turnstile-response, a także przekazuje go do pola callback widżetu. Następnie serwer witryny wysyła token do Cloudflare Siteverify API użytkownika, aby to potwierdzić.
Właściwości tokena zgodnie z dokumentacją Cloudflare:
Ważne przez 300 sekund (5 minut) po wygenerowaniu.
Jednorazowe: sprawdzenie poprawności po raz drugi powoduje zwrócenie błędu timeout-or-duplicate.
Długość do 2048 znaków.
Sprawdzone na serwerze poprzez Siteverify API.
CapMonster Cloud akceptuje parametry captcha, przetwarza je na swoich serwerach i zwraca gotowy do użycia token. Wstaw ten token do formularza, aby przejść kontrolę bez interakcji użytkownika.
Na tym etapie wysyłasz swój klucz API, typ captcha i jego parametry. Usługa zwraca unikalny taskId, którego możesz użyć później, aby uzyskać wynik.
Wymagane parametry
| Parametr | Opis |
|---|---|
| wpisz | TurnstileTask |
| websiteURL | Adres URL strony, na której rozwiązano captcha |
| websiteKey | Turnstile klucz witryny. Format: 0x4AAAAAAABUYP0XeMJF0xoy |
Parametry opcjonalne
| Parametr | Opis |
|---|---|
| userAgent | Przeglądarka User-Agent. Zalecane: przekaż bieżącą wartość obsługiwaną przez CapMonster Cloud. Najnowszą wartość możesz uzyskać pod adresem https://capmonster.cloud/api/useragent/actual |
| pageAction | Pole akcji znalezione w funkcji callback po załadowaniu captcha |
| dane | Wartość pola danych pobrana z parametru cData |
| typ proxy | http — zwykły serwer proxy HTTP/HTTPS; https — spróbuj tego, jeśli http nie działa (wymagane w przypadku niektórych niestandardowych serwerów proxy); socks4 — proxy SOCKS4; socks5 — proxy SOCKS5 |
| adres proxy | Adres IP proxy (IPv4/IPv6). Przezroczyste proxy i proxy na komputerach lokalnych są niedozwolone |
| proxyPort | Port proxy |
| proxyZaloguj się | Nazwa użytkownika proxy |
| hasło proxy | Hasło proxy |
Ten sam typ TurnstileTask jest używany z serwerem proxy i bez niego.
Punkt końcowy:
https://api.capmonster.cloud/createTaskŻądanie:
{
"clientKey": "API_KEY",
"task": {
"type": "TurnstileTask",
"websiteURL": "https://yourwebsite.com/page-with-turnstile",
"websiteKey": "your-website-key"
}
}Odpowiedź:
{
"errorId": 0,
"taskId": 407533072
}Po utworzeniu zadania sprawdź stan rozwiązania.
Punkt końcowy:
https://api.capmonster.cloud/getTaskResultŻądanie:
{
"clientKey": "API_KEY",
"taskId": 407533072
}Odpowiedź:
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36",
"token": "0.iGX3xsyFCkbGePM3jP4P4khLo6TrLukt8ZzBvwuQOvbC...f61f3082"
}
}| Własność | Wpisz | Opis |
|---|---|---|
| żeton | Sznurek | Użyj tokena w polu wejściowym lub podczas wywoływania funkcji callback. |
Wpisz zwrócony token w pole cf-turnstile-response lub przekaż go do callback widżetu, a następnie wyślij formularz w ciągu pięciu minut: Tokeny Cloudflare tracą ważność po 300 sekundach i można je zweryfikować tylko raz. Przykłady kodów dla Playwright, Puppeteer i Selenium znajdują się w FAQ poniżej.
Aby utworzyć zadanie Turnstile potrzebne są dwie wartości ze strony, na której działa widget: klucz witryny (websiteKey) oraz, jeśli strona to ustawia, nazwa akcji (pageAction).
<div class="cf-turnstile" data-sitekey="SITE_KEY"← websiteKey
data-action="ACTION"></div>← pageActionturnstile.render('#container', {
sitekey: 'SITE_KEY',← websiteKey
action: 'ACTION',← pageAction
callback: function (token) { /* ... */ }
});Otwórz witrynę za pomocą captcha.
Kliknij prawym przyciskiem myszy element captcha i wybierz Inspect.
Znajdź klucz witryny. W zakładce Elements jest to atrybut data-sitekey (websiteKey). Klucz witryny Turnstile wygląda jak 0x4AAAAAAABUYP0XeMJF0xoy.
Znajdź akcję: w wywołaniu renderowania widżetu (funkcja callback uruchamiana po załadowaniu captcha) lub w atrybucie data-action. Klucz witryny można również znaleźć w funkcji callback. Jeśli strona nie ustawia akcji, pomiń ten parametr.
Aby automatycznie zbierać wartości, załaduj stronę w bezobsługowej przeglądarce, takiej jak Playwright i odczytaj je z wyrenderowanego widżetu. Gotowe przykłady w JavaScript, Python i C# znajdują się w CapMonster Cloud dokumentacja.
Niektóre wartości zmieniają się przy każdym załadowaniu strony, więc rozwiązuj zadanie zaraz po ich zebraniu.
createTask i pobrać wynik za pomocą getTaskResult przy użyciu naszych bibliotek klienckich.W przypadku przepływów pracy wymagających niewielkiej ilości kodu użyj oficjalnego węzła CapMonster Cloud n8n .
websiteURL i websiteKey z tego samego renderowania strony.getTaskResult zwróciło status ready i czy przed wstawieniem wziąłeś solution.token.Błędy zwracane przez Cloudflare Siteverify (timeout-or-duplicate, invalid-input-secret i inne) dotyczą właścicieli witryn — zobacz „Siteverify kody błędów” poniżej.
Jeśli prowadzisz witrynę chronioną przez Turnstile: zweryfikuj tokeny i przetestuj swoją konfigurację
POST https://challenges.cloudflare.com/turnstile/v0/siteverify
secret=YOUR_SECRET_KEY
response=TOKENJeśli prowadzisz witrynę, Twój serwer sprawdza każdy token Turnstile, wysyłając żądanie POST na adres https://challenges.cloudflare.com/turnstile/v0/siteverify. Punkt końcowy akceptuje application/x-www-form-urlencoded i JSON i zawsze zwraca JSON. Wymagane parametry: secret (tajny klucz Twojego widżetu) i response (token). Opcjonalnie: remoteip i idempotency_key. Sprawdź success i, jeśli je ustawisz, także action i hostname w odpowiedzi.
Token jest ważny przez 300 sekund i może zostać zweryfikowany tylko raz. Przeczytaj więcej w Cloudflare przewodniku walidacyjnym.
Cloudflare zapewnia fikcyjne klucze witryny i tajne klucze, dzięki czemu możesz przetestować implementację Turnstile bez powodowania prawdziwych wyzwań. Przetestuj klucze witryny, które działają w dowolnej domenie, w tym localhost, i wygeneruj fikcyjny token XXXX.DUMMY.TOKEN.XXXX. Atrapy tokenów są akceptowane tylko przez fałszywe klucze tajne, a tajne klucze produkcyjne je odrzucają.
<div class="cf-turnstile"
data-sitekey="1x…AA">
</div>
cf-turnstile-response:
"XXXX.DUMMY.TOKEN.XXXX"Zawsze przechodzi
Zawsze zawodzi
Zawsze przechodzi
Zawsze zawodzi
Wymusza interaktywne wyzwanie
Zawsze przechodzi weryfikację
Zawsze kończy się niepowodzeniem
Zwraca błąd „token już wydany” (przekroczenie limitu czasu lub duplikat)
Pełne referencje Cloudflare: Turnstile testowanie.
Jeśli weryfikacja nie powiedzie się, Cloudflare Siteverify API zwraca tablicę error-codes. Poniższa tabela zawiera listę poszczególnych kodów i ich znaczenie.
{
"success": false,
"error-codes": [
"timeout-or-duplicate"
]
}Nie podano tajnego parametru
Tajny klucz jest nieprawidłowy lub wygasł
Nie podano parametru odpowiedzi (tokenu).
Token jest nieprawidłowy, zniekształcony lub wygasł
Żądanie jest źle sformułowane
Token został już zweryfikowany lub wygasł
Wystąpił błąd wewnętrzny; ponów żądanie
Siteverify może zwrócić success: true, a Twój serwer powinien mimo to odrzucić token, jeśli hostname lub action nie odpowiadają oczekiwaniom.
Krótkie odpowiedzi na temat rozwiązywania Cloudflare Turnstile za pomocą CapMonster Cloud: tryby, proxy, tokeny, testowanie i błędy Siteverify.
Cloudflare Turnstile to alternatywa CAPTCHA od Cloudflare, która weryfikuje odwiedzających za pomocą sygnałów przeglądarki i oceny ryzyka zamiast zagadek obrazkowych. Posiada trzy tryby widgetów. Managed (zalecane): Cloudflare wybiera pomiędzy zaznaczeniem non-interactive a polem wyboru w oparciu o ryzyko odwiedzającego. Non-interactive: widoczny widget z pokrętłem ładującym, który nigdy nie wymaga interakcji. Invisible: brak widżetu. CapMonster Cloud obsługuje wszystkie trzy automatycznie, więc nie określasz trybu w zadaniu.
Nr TurnstileTask działa bez proxy, a pola proxy (proxyType, proxyAddress, proxyPort, proxyLogin, proxyPassword) są opcjonalne. Serwer proxy odpowiadający geografii witryny docelowej może poprawić wyniki na stronach wrażliwych geograficznie, dlatego warto przetestować obie konfiguracje. Przezroczyste proxy i proxy na komputerach lokalnych są niedozwolone. Bez własnego serwera proxy CapMonster Cloud rozwiązuje zadanie poprzez wbudowane serwery proxy (adres IP 65.21.190.34).
Otwórz DevTools, znajdź element z atrybutem data-sitekey (oraz data-action, jeśli strona ustawia akcję) i skopiuj wartości; klucz witryny Turnstile wygląda jak 0x4AAAAAAABUYP0XeMJF0xoy. Niektóre wartości zmieniają się przy każdym ładowaniu strony, więc wyodrębnij je tuż przed utworzeniem zadania. Instrukcje krok po kroku znajdują się w sekcji powyżej.
cf-turnstile-response to ukryte pole formularza, w którym znajduje się token Turnstile. Token jest ważny przez 300 sekund (5 minut) i może zostać zatwierdzony tylko raz; następnie Siteverify zwraca błąd timeout-or-duplicate. Od razu prześlij token otrzymany od CapMonster Cloud i poproś o nowy przy każdym przesłaniu .
Aby wstawić token Turnstile, znajdź ukryte pole odpowiedzi (wejście o nazwie cf-turnstile-response) i ustaw je na token pobrany z CapMonster Cloud. Oto, jak to zrobić w trzech platformach automatyzacji.
Playwright / Puppeteer (Node.js):
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.querySelector('[name="cf-turnstile-response"]').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python):
token = "YOUR_TOKEN"
driver.execute_script("document.querySelector('[name=\"cf-turnstile-response\"]').value = arguments[0];", token)
driver.find_element("id", "submit-btn").click()Jeśli formularz sprawdza poprawność tokena za pomocą funkcji callback (atrybut data-callback widżetu), zamiast tego wywołaj tę funkcję za pomocą tokena.
Użyj fikcyjnych kluczy Cloudflare. Na kliencie ustaw klucz witryny na 1x00000000000000000000AA (zawsze kończy się pomyślnie), 2x00000000000000000000AB (zawsze kończy się niepowodzeniem) lub 3x00000000000000000000FF (wymusza wyzwanie interaktywne); na serwerze użyj fałszywego tajnego klucza, takiego jak 1x0000000000000000000000000000000AA. Atrapy kluczy witryny działają w dowolnej domenie, w tym localhost, i generują token XXXX.DUMMY.TOKEN.XXXX, który akceptują tylko fikcyjne klucze tajne. Pełna lista znajduje się w sekcji test powyżej.
Siteverify zwraca success: false, gdy token jest starszy niż 300 sekund, został już zweryfikowany lub tajny klucz jest błędny, a Twój serwer może go również odrzucić, jeśli zwrócony hostname lub action nie odpowiada oczekiwaniom. Sprawdź tablicę error-codes w odpowiedzi i zobacz tabelę kodów błędów Siteverify. Poproś o nowy token dla każdego zgłoszenia i wyślij go zaraz po jego otrzymaniu.
* Nie gwarantujemy 100% skuteczności: typy CAPTCHA i konfiguracja witryny docelowej mogą ulec zmianie w dowolnym momencie. CapMonster Cloud zapewnia wysoki wskaźnik powodzenia rozwiązywania Cloudflare Turnstile. Na podstawie CapMonster Cloud wewnętrznego miesięcznego testu porównawczego zespołu. Rzeczywista szybkość rozwiązywania problemów i wskaźnik powodzenia różnią się w zależności od witryny docelowej, obciążenia serwera i warunków sieciowych.
Cloudflare i Turnstile są znakami towarowymi firmy Cloudflare, Inc. CapMonster Cloud nie jest powiązane ani wspierane przez Cloudflare. Usługa przeznaczona jest do publicznie dostępnych danych, testowania własnych lub autoryzowanych stron internetowych, rozpoznawania obrazu i dostępności. Zbieranie danych osób trzecich za loginem lub zaporą płatniczą bez pozwolenia jest zabronione; nie ma to wpływu na Twoje konta. Stan prawny swoich danych ustalasz przed rozpoczęciem pracy.