Vytvořte vlastní pravidla chyb

1. V Cloudflare dashboardu přejděte do sekce Rules Přehled stránce.

   Přejděte na Přehled ↗

2. Vyberte Vytvořit pravidlo > Vlastní pravidlo chyby.

3. Zadejte popisný název pravidla do Název pravidla.

4. V části Pokud příchozí požadavky odpovídají, vyberte jednu z následujících možností:

   • Custom filter expression: Pravidlo se použije pouze na provoz odpovídající vlastnímu výrazu. Definujte výraz pravidla pro nastavení, které požadavky mají být přepsány. K definování vlastního výrazu použijte buď Expression Builder, nebo Expression Editor. Další informace najdete v Úprava výrazů v dashboardu.

   • Všechny příchozí požadavky: Pravidlo se použije na všechny odpovědi s 400 nebo vyšším, s výjimkou akcí blokování a výzvy vydaných bezpečnostními produkty Cloudflare.

5. V Doručení vlastní chybové odpovědi, vyberte typ odpovědi (buď Vlastní chybové aktivum nebo některou z dostupných vložených odpovědí).

   Pokud vyberete Vlastní chybové aktivum, vyberte existující vlastní chybový prostředek v Prostředek, nebo vyberte Vytvořit nové aktivum na vytvořit nové vlastní chybové aktivum.

   Pokud vyberete Odpověď JSON, Odpověď HTML, Textová odpověď, nebo Odpověď XML, zadejte vlastní chybovou odpověď, kterou chcete odeslat návštěvníkům webu, v Odpověď JSON, Odpověď HTML, Textová odpověď, nebo Odpověď XML, v uvedeném pořadí. Odpověď může obsahovat chybové tokeny které Cloudflare nahradí skutečnými hodnotami před odesláním odpovědi návštěvníkovi. Maximální velikost odpovědi je 10 KB.

6. (Volitelné) V Kód odpovědi, zadejte stavový kód HTTP odpovědi (celé číslo mezi 400 a 999). Pokud je tato hodnota zadána, přepíše aktuální stavový kód odpovědi.

7. (Volitelné) V části Umístit na, určete, kam pravidlo v seznamu pravidel umístit: jako první pravidlo v seznamu, jako poslední pravidlo v seznamu, nebo na vlastní pozici (za konkrétní pravidlo).

8. Chcete-li pravidlo uložit a nasadit, vyberte Nasadit. Pokud ještě nejste připraveni pravidlo nasadit, vyberte Save as Draft.

1. V Vytvořte vlastní chybový soubor na postranním panelu zadejte název prostředku v Název prostředku.
2. (Volitelné) Zadejte popis prostředku v Popis.
3. V URL, zadejte URL adresu stránky, kterou chcete načíst a uložit do globální sítě Cloudflare. Cloudflare načte všechny prostředky stránky a uloží zminifikovanou verzi stránky, kterou pak můžete použít v jednom nebo více vlastních chybových pravidlech.
4. Vyberte Save.

1. (Volitelné) Vytvořte vlastní chybový soubor na základě adresy URL, kterou zadáte.
2. Vytvořte vlastní chybové pravidlo v http_custom_errors fázi pomocí Rulesets API.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_pages/assets" \
--header "Authorization: Bearer <API_TOKEN>" \
--json '{
  "name": "500_error_template",
  "description": "Standard 5xx error template page",
  "url": "https://example.com/errors/500_template.html"
}'

{
	"result": {
		"name": "500_error_template",
		"description": "Standard 5xx error template page",
		"url": "https://example.com/errors/500_template.html",
		"last_updated": "2025-02-10T11:36:07.810215Z",
		"size_bytes": 2048
	},
	"success": true
}

1. Použijte Seznam sad pravidel zóny operaci pro kontrolu, zda již existuje ruleset pro http_custom_errors fázi na úrovni zóny.

2. Pokud fázový ruleset neexistuje, vytvořte jej pomocí Aktualizace vstupní sady pravidel zóny operaci, která umožňuje vytvořit ruleset, pokud neexistuje, a aktualizovat všechna pravidla v rulesetu. Ruleset vytvořte v http_custom_errors fáze.

   Pokud sada pravidel (ruleset) pro danou fázi již existuje, použijte Aktualizace vstupní sady pravidel zóny operaci pro nahrazení všech pravidel v rulesetu, nebo Přidání pravidla do sady pravidel operaci pro přidání pravidla ke stávajícím pravidlům v rulesetu.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/phases/http_custom_errors/entrypoint" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"rules": [
				{
						"ref": "serve_500_template",
						"action": "serve_error",
						"action_parameters": {
								"asset_name": "500_error_template",
								"content_type": "text/html"
						},
						"expression": "http.response.code eq 500",
						"enabled": true
				}
		]
	}'