← Cloudflare Fundamentals / fundamentals / reference

Ответы с ошибками

Когда Cloudflare не может выполнить запрос, она формирует ответ с ошибкой. Формат зависит от того, что запрашивает клиент через Accept заголовке, а также в настройках зоны Custom Errors конфигурации.

По умолчанию ответы об ошибках возвращаются в формате HTML. Клиенты, запрашивающие структурированный формат (например, application/json, application/problem+json, или text/markdown) получают вместо этого машиночитаемый ответ. Этот машиночитаемый ответ охватывает все Коды ошибок 1xxx (которые возвращают коды состояния HTTP 4xx или 5xx в зависимости от ошибки) и созданные Cloudflare Ошибки 5xx (500, 502, 504, 520-526). Ответы с ошибками 5xx, которые генерирует исходный сервер, Cloudflare передаёт клиенту без изменений.

Cloudflare выбирает формат ответа на основе клиентского Accept заголовок, следуя стандартным Согласование содержимого HTTP ↗. Если допустимо несколько форматов, используются коэффициенты качества (q значений) определяют приоритет. При одинаковом значении качества побеждает тип, указанный первым в списке.

Структурированные ответы об ошибках доступны на всех тарифных планах, включая план Free. Custom Error Rules для переопределения этих ответов требуют платного тарифного плана Cloudflare.

Структурированные ответы об ошибках используются по умолчанию для зон без пользовательской настройки ошибок. Зоны, которые используют Custom Errors сохраняют полный контроль над тем, что получают клиенты.

То, что получает клиент, зависит от того, какие функции настраиваемых ошибок включены в вашей зоне. Подробности приведены в следующих разделах.

Это значение по умолчанию для большинства зон. Cloudflare отдаёт свой стандартный ответ об ошибке в формате, который запрашивает клиент.

В зоне загружена Error Page через дашборд Cloudflare. Пользовательские правила ошибок (Custom Error Rules) не настроены. Error Page отображается всем клиентам независимо от Accept заголовок. Error Pages не выполняют согласование содержимого.

Если вы хотите, чтобы агенты получали структурированные ответы, сохранив при этом собственный HTML для браузеров, добавьте Custom Error Rule, соответствующее Accept заголовок. Подробности см. в следующем разделе.

В зоне есть одно или несколько Custom Error Rules (доступно на платных тарифных планах). Они имеют приоритет над Error Pages. Вы сами определяете, что показывать, кому и при каких условиях.

Custom Error Rules могут применяться к любому заголовку запроса, включая Accept, и может ориентироваться на конкретные коды ошибок. В рамках одной и той же зоны вы можете отдавать JSON API-клиентам, Markdown агентам и HTML браузерам.

Когда Cloudflare формирует ответ с ошибкой, то, что получит клиент, определяется следующим порядком приоритета:

1. Custom Error Rules : Если правило соответствует условиям ошибки и запроса, отдаётся содержимое этого правила.
2. Error Pages : Если для данного типа ошибки настроена Error Page и ни одно Custom Error Rule не совпало, Error Page отдаётся в формате HTML независимо от Accept заголовок.
3. Структурированные ответы об ошибках : Если ни одно Custom Error Rule не совпало и Error Page не настроена, Cloudflare отдаёт ответ по умолчанию в формате, запрошенном клиентом (JSON, Markdown или HTML).

Полный порядок приоритета, включая соотношение правил уровня аккаунта и уровня зоны, пользовательские блокирующие ответы WAF и страницы проверки безопасности, см. в Custom Errors документация.

{
	"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.

Получите структурированный JSON-ответ для ошибки 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 .

Получите структурированный 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"

Проверьте наличие Retry-After заголовок при повторяемой ошибке:

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

Ответы в форматах JSON и Markdown содержат один и тот же набор полей. В ответах JSON поля возвращаются в виде плоского объекта, а в ответах Markdown они располагаются во frontmatter YAML, за которым следуют текстовые разделы. Приведённые ниже описания полей относятся к обоим форматам.

Ответы в формате JSON соответствуют RFC 9457 (Problem Details for HTTP APIs) ↗. Любой HTTP клиент, поддерживающий Problem Details, может разобрать пять стандартных полей (type, title, status, detail, instance) без специфичного для Cloudflare кода.

Ответы в формате Markdown размещают эти поля в YAML frontmatter (между --- разделители), а затем три текстовых раздела:

• # Error {code}: {description} : заголовок с кодом ошибки и кратким описанием.
• ## What Happened : соответствует detail поле.
• ## What You Should Do : соответствует what_you_should_do поле.

Frontmatter не включает стандартные поля RFC 9457 (type, title, instance) и footer поле, поскольку они либо дублируют текстовое описание, либо неприменимы к формату Markdown.

error_category поле классифицирует ошибку, чтобы клиенты могли определять поведение при повторных попытках и эскалации, не разбирая текстовые поля.

К повторяемым кодам ошибок относится стандартный Retry-After ↗ заголовка HTTP-ответа. Значение заголовка в секундах совпадает со значением retry_after поле в теле ответа.

Коды, для которых повтор не выполняется (525, 526), не включают Retry-After заголовок.

Шесть повторяемых кодов ошибок 1xxx создают Retry-After:

Все остальные коды ошибок 1xxx не подлежат повторной попытке и не содержат Retry-After заголовок.

Если правило ограничения частоты запросов WAF уже установило динамический Retry-After значение в ответе, это значение имеет приоритет над значением по умолчанию.

• Ошибки Cloudflare 1xxx
• Ошибки Cloudflare 5xx
• Custom Errors
• Лимиты подключений
• Markdown for Agents (преобразование содержимого)
• RFC 9457: Problem Details for HTTP APIs ↗