← Cloudflare Rules / rules / url-forwarding / single-redirects

Nastavení Single Redirects

Následující části popisují nastavení redirect rules pro konfiguraci statických a dynamických přesměrování URL.

Provádí přesměrování URL pomocí vzory se zástupnými znaky pro shodu s více požadavky. Tento způsob zjednodušuje definování vzorů zdrojových a cílových URL adres bez nutnosti používat složité výrazy.

Přesměrování URL se zástupnými znaky má následující konfigurační parametry:

• Request URL: Zadejte vzor se zástupnými znaky pomocí hvězdičky (*) znak pro shodu s více požadavky. Například https://*.example.com/files/*.

• Cílová URL: Zadejte cílovou URL, která může být statická (například https://example.com) nebo dynamickou (například https://example.com/${1}/files/${2}). Použijte nahrazování pomocí zástupných znaků jako ${1}, ${2}, atd., k definování dynamických cílů.

• Stavový kód: Stavový kód HTTP odpovědi přesměrování (301 - Trvalé přesměrování výchozí). Musí to být jedna z následujících hodnot:

  • 301 - Trvalé přesměrování: Stránka se natrvalo přesunula na novou adresu. Pro POST požadavků může klient nebo prohlížeč přepnout metodu HTTP na GET při sledování přesměrování.
  • 302 - Dočasné přesměrování: Stránka se dočasně přesunula na novou adresu. Pro POST požadavků může klient nebo prohlížeč přepnout metodu HTTP na GET při sledování přesměrování.
  • 307 - Pokročilé: dočasné, zachovává metodu HTTP: Stránka se dočasně přesunula na novou adresu. Klient nebo prohlížeč musí zachovat původní HTTP metodu (například POST) při sledování přesměrování.
  • 308 - Pokročilé: trvalé, zachovává metodu HTTP: Stránka se natrvalo přesunula na novou adresu. Klient nebo prohlížeč musí zachovat původní HTTP metodu (například POST) při sledování přesměrování.

• Preserve query string: Určuje, zda se má při přesměrování zachovat query string (ve výchozím nastavení vypnuto).

"action_parameters": {
  "from_value": {
    "target_url": {
      "expression": "wildcard_replace(http.request.full_uri, r\"<REQUEST_URL_PATTERN>\", r\"<TARGET_URL_PATTERN>\")"
    },
    "status_code": <STATUS_CODE>,
    "preserve_query_string": <BOOLEAN_VALUE>
  }
}

Provádí statické přesměrování URL se zadaným stavovým kódem HTTP a volitelně zachovává query string.

Statické přesměrování URL má následující konfigurační parametry:

• URL: Doslovný řetězec, který se použije v Location hlavičku HTTP vrácenou v odpovědi na přesměrování.

• Stavový kód: Stavový kód HTTP odpovědi přesměrování (301 - Trvalé přesměrování výchozí). Musí to být jedna z následujících hodnot:

  • 301 - Trvalé přesměrování: Stránka se natrvalo přesunula na novou adresu. Pro POST požadavků může klient nebo prohlížeč přepnout metodu HTTP na GET při sledování přesměrování.
  • 302 - Dočasné přesměrování: Stránka se dočasně přesunula na novou adresu. Pro POST požadavků může klient nebo prohlížeč přepnout metodu HTTP na GET při sledování přesměrování.
  • 307 - Pokročilé: dočasné, zachovává metodu HTTP: Stránka se dočasně přesunula na novou adresu. Klient nebo prohlížeč musí zachovat původní HTTP metodu (například POST) při sledování přesměrování.
  • 308 - Pokročilé: trvalé, zachovává metodu HTTP: Stránka se natrvalo přesunula na novou adresu. Klient nebo prohlížeč musí zachovat původní HTTP metodu (například POST) při sledování přesměrování.

• Preserve query string: Určuje, zda se má při přesměrování zachovat query string (ve výchozím nastavení vypnuto).

"action_parameters": {
  "from_value": {
    "target_url": {
      "value": "<STATIC_URL_VALUE>"
    },
    "status_code": <STATUS_CODE>,
    "preserve_query_string": <BOOLEAN_VALUE>
  }
}

Provádí dynamické přesměrování URL, u kterého se cílová URL adresa určuje pomocí výrazu. Můžete nastavit stavový kód HTTP přesměrování a zda se má při přesměrování zachovat query string.

Dynamické přesměrování URL má následující konfigurační parametry:

• Výraz: výraz která definuje cílovou URL přesměrování. Výsledek vyhodnocení tohoto výrazu se použije v Location hlavičku HTTP vrácenou v odpovědi na přesměrování. Viz pole a funkce které můžete použít ve výrazech.

• Stavový kód: Stavový kód HTTP odpovědi přesměrování (301 - Trvalé přesměrování výchozí). Musí to být jedna z následujících hodnot:

  • 301 - Trvalé přesměrování: Stránka se natrvalo přesunula na novou adresu. Pro POST požadavků může klient nebo prohlížeč přepnout metodu HTTP na GET při sledování přesměrování.
  • 302 - Dočasné přesměrování: Stránka se dočasně přesunula na novou adresu. Pro POST požadavků může klient nebo prohlížeč přepnout metodu HTTP na GET při sledování přesměrování.
  • 307 - Pokročilé: dočasné, zachovává metodu HTTP: Stránka se dočasně přesunula na novou adresu. Klient nebo prohlížeč musí zachovat původní HTTP metodu (například POST) při sledování přesměrování.
  • 308 - Pokročilé: trvalé, zachovává metodu HTTP: Stránka se natrvalo přesunula na novou adresu. Klient nebo prohlížeč musí zachovat původní HTTP metodu (například POST) při sledování přesměrování.

• Preserve query string: Určuje, zda se má při přesměrování zachovat query string (ve výchozím nastavení vypnuto).

"action_parameters": {
  "from_value": {
    "target_url": {
      "expression": "<DYNAMIC_URL_EXPRESSION>"
    },
    "status_code": <STATUS_CODE>,
    "preserve_query_string": <BOOLEAN_VALUE>
  }
}