← Cloudflare Fundamentals / fundamentals / reference

Chybové odpovědi

Když Cloudflare nemůže dokončit požadavek, vygeneruje chybovou odpověď. Formát závisí na tom, co klient požaduje prostřednictvím Accept hlavička a na úrovni zóny Vlastní chyby konfigurace.

Ve výchozím nastavení jsou chybové odpovědi ve formátu HTML. Klienti, kteří požadují strukturovaný formát (například application/json, application/problem+json, nebo text/markdown) obdrží místo toho strojově čitelnou odpověď. Tato strojově čitelná odpověď zahrnuje všechny Kódy chyb řady 1xxx (které vracejí stavové kódy HTTP 4xx nebo 5xx v závislosti na chybě) a Cloudflare generovanými Chyby řady 5xx (500, 502, 504, 520-526). Odpovědi s chybami 5xx generované původním serverem předává Cloudflare klientovi beze změny.

Cloudflare volí formát odpovědi na základě klienta a jeho Accept hlavičku podle standardní Vyjednávání obsahu HTTP ↗. Pokud je přijatelných více formátů, faktory kvality (q hodnot) určují prioritu. Při stejné hodnotě kvality vítězí typ uvedený jako první.

Strukturované chybové odpovědi jsou dostupné ve všech plánech, včetně plánu Free. Vlastní pravidla chyb pro přepsání těchto odpovědí vyžadují placený plán Cloudflare.

Strukturované chybové odpovědi jsou výchozí pro zóny bez vlastní konfigurace chyb. Zóny, které používají Vlastní chyby si zachovávají plnou kontrolu nad tím, co klienti dostávají.

To, co klient obdrží, závisí na tom, které funkce vlastních chybových stránek máte pro svou zónu nakonfigurované. Podrobnosti najdete v následujících částech.

Toto je výchozí nastavení pro většinu zón. Cloudflare vrací svou výchozí chybovou odpověď ve formátu, který klient požaduje.

Na zóně je nahraná chybová stránka prostřednictvím Cloudflare dashboardu. Nejsou nakonfigurována žádná vlastní pravidla pro chyby. Chybová stránka se zobrazuje všem klientům bez ohledu na Accept hlavičku: Error Pages neprovádějí vyjednávání obsahu.

Pokud chcete, aby agenti dostávali strukturované odpovědi, a zároveň si chcete zachovat vlastní HTML pro prohlížeče, přidejte Custom Error Rule, které odpovídá Accept hlavičku. Podrobnosti najdete v další části.

Zóna má jeden nebo více Vlastní pravidla chyb (dostupné v placených plánech). Mají přednost před Error Pages. Určujete, co se zobrazí, komu a za jakých podmínek.

Custom Error Rules mohou porovnávat libovolnou hlavičku požadavku, včetně Accept, a může cílit na konkrétní chybové kódy. Ze stejné zóny tak můžete klientům API poskytovat JSON, agentům Markdown a prohlížečům HTML.

Když Cloudflare vygeneruje chybovou odpověď, o tom, co klient obdrží, rozhoduje následující pořadí priorit:

1. Vlastní pravidla chyb : Pokud pravidlo odpovídá podmínkám chyby a požadavku, je obsloužen obsah tohoto pravidla.
2. Chybové stránky : Pokud je pro daný typ chyby nakonfigurována stránka Error Page a neodpovídalo žádné vlastní pravidlo chyby (Custom Error Rule), je stránka Error Page obsloužena jako HTML bez ohledu na Accept hlavička.
3. Strukturované chybové odpovědi : Pokud neodpovídalo žádné vlastní pravidlo chyby a není nakonfigurována žádná stránka Error Page, Cloudflare obslouží svou výchozí odpověď ve formátu, který klient požadoval (JSON, Markdown nebo HTML).

Úplné pořadí priority, včetně pravidel na úrovni účtu oproti pravidlům na úrovni zóny, vlastních blokovacích odpovědí WAF a bezpečnostních výzev, najdete v Vlastní chyby dokumentace.

{
	"type": "https://developers.cloudflare.com/support/troubleshooting/http-status-codes/cloudflare-5xx-errors/error-522/",
	"title": "Error 522: Connection timed out",
	"status": 522,
	"detail": "Cloudflare could not establish a TCP connection to the origin server. The TCP handshake timed out, which may indicate the origin is overloaded, firewalling Cloudflare, or unreachable at the network level.",
	"instance": "9f140b785e57c458",
	"error_code": 522,
	"error_name": "connection_timeout",
	"error_category": "origin",
	"ray_id": "9f140b785e57c458",
	"timestamp": "2026-04-24T09:22:40Z",
	"zone": "example.com",
	"cloudflare_error": true,
	"retryable": true,
	"retry_after": 120,
	"owner_action_required": true,
	"what_you_should_do": "**Wait and retry.** Back off for at least 120 seconds. If the error persists, the website operator should verify firewall rules and ensure the origin accepts connections from Cloudflare IP ranges.",
	"footer": "This error was generated by Cloudflare on behalf of the website owner."
}

---
error_code: 522
error_name: connection_timeout
error_category: origin
status: 522
ray_id: 9f140b785e57c458
timestamp: 2026-04-24T09:22:40Z
zone: example.com
cloudflare_error: true
retryable: true
retry_after: 120
owner_action_required: true
---

# Error 522: Connection timed out

## What Happened

Cloudflare could not establish a TCP connection to the origin server. The TCP handshake timed out, which may indicate the origin is overloaded, firewalling Cloudflare, or unreachable at the network level.

## What You Should Do

**Wait and retry.** Back off for at least 120 seconds. If the error persists, the website operator should verify firewall rules and ensure the origin accepts connections from Cloudflare IP ranges.

---

This error was generated by Cloudflare on behalf of the website owner.

Načtěte strukturovanou odpověď ve formátu JSON pro chybu 522:

curl --silent --compressed --header "Accept: application/json" \
  --user-agent "TestAgent/1.0" --header "Accept-Encoding: gzip, deflate" \
  "https://example.com/cdn-cgi/error/522" | jq .

Načtěte strukturovanou odpověď ve formátu Markdown:

curl --silent --compressed --header "Accept: text/markdown" \
  --user-agent "TestAgent/1.0" --header "Accept-Encoding: gzip, deflate" \
  "https://example.com/cdn-cgi/error/522"

Zkontrolujte přítomnost Retry-After hlavičku při chybě, kterou lze opakovat:

curl --silent --compressed --dump-header - --output /dev/null \
  --header "Accept: application/json" --user-agent "TestAgent/1.0" \
  --header "Accept-Encoding: gzip, deflate" \
  "https://example.com/cdn-cgi/error/521" | grep -i retry-after

Odpovědi ve formátu JSON i Markdown obsahují stejnou sadu polí. Odpovědi JSON je vracejí jako plochý objekt, odpovědi Markdown je umisťují do YAML frontmatteru následovaného textovými částmi. Definice polí uvedené níže platí pro oba formáty.

Odpovědi JSON se řídí RFC 9457 (Problem Details for HTTP APIs) ↗. Jakýkoli HTTP klient, který rozumí Problem Details, dokáže analyzovat pět standardních členů (type, title, status, detail, instance) bez kódu specifického pro Cloudflare.

Odpovědi ve formátu Markdown umisťují tato pole do YAML frontmatter (mezi --- oddělovačů) a poté následují tři textové oddíly:

• # Error {code}: {description}, nadpis s kódem chyby a stručným popisem.
• ## What Happened, odpovídá detail .
• ## What You Should Do, odpovídá what_you_should_do .

Frontmatter vynechává standardní členy RFC 9457 (type, title, instance) a footer pole, protože jsou buď redundantní vůči textu, nebo se na formát Markdown nevztahují.

error_category pole klasifikuje chybu, takže klienti mohou řídit opakování požadavků a eskalaci, aniž by museli parsovat textová pole.

Mezi opakovatelné chybové kódy patří standardní Retry-After ↗ HTTP hlavička odpovědi. Hodnota hlavičky v sekundách odpovídá retry_after pole v těle odpovědi.

Kódy, které nelze opakovat (525, 526), neobsahují Retry-After hlavička.

Šest opakovatelných chybových kódů řady 1xxx generuje Retry-After:

Všechny ostatní chybové kódy řady 1xxx nelze opakovat a neobsahují Retry-After hlavička.

Pokud pravidlo WAF pro omezení frekvence požadavků již nastavilo dynamickou Retry-After hodnota v odpovědi, má tato hodnota přednost před výchozí hodnotou.

• Chyby Cloudflare 1xxx
• Chyby Cloudflare 5xx
• Vlastní chyby
• Limity připojení
• Markdown for Agents (konverze obsahu)
• RFC 9457: Problem Details for HTTP APIs ↗