← Images / images / reference

Řešení potíží

Obsahuje odpověď Cf-Resized hlavička? Pokud ne, změna velikosti nebyla provedena. Možné příčiny:

• Tato funkce není v Cloudflare Dashboard povolena.
• Na stejném požadavku běží další Worker. Jakmile jeden Worker zavolá druhý, změna velikosti se "zapomene". Nepoužívejte Workery s platností pro celou doménu /*.
• Náhled v Editoru v Cloudflare Dashboard nesimuluje změnu velikosti obrázku. Worker je nutné nasadit a otestovat v jiné kartě prohlížeče.

Pokud změna velikosti selže, tělo odpovědi obsahuje chybovou zprávu s vysvětlením důvodu a také Cf-Resized hlavičku obsahující err=code:

• 9401: Povinné argumenty v {cf:image{…}} chybí nebo jsou neplatné. Zkuste to znovu. Více informací naleznete v Možnosti fetch pro podporované argumenty.
• 9402: Obrázek byl příliš velký nebo bylo přerušeno spojení. Více informací najdete v Podporované formáty a omezení s dalšími informacemi.
• 9403: smyčka požadavků nastala proto, že obrázku již byla změněna velikost nebo Worker načetl svou vlastní URL adresu. Zkontrolujte, že se cesta Workeru a cesta k obrázku na serveru nepřekrývají.
• 9406 a 9419: Adresa URL obrázku nepoužívá protokol HTTPS nebo obsahuje mezery či neescapované znaky Unicode. Zkontrolujte adresu URL a zkuste to znovu.
• 9407: Při překladu doménového jména originového serveru došlo k chybě vyhledávání. Zkontrolujte nastavení DNS a zkuste to znovu.
• 9404: Obrázek na originovém serveru neexistuje nebo je nesprávná adresa URL použitá k jeho změně velikosti. Ověřte, že obrázek existuje, a zkontrolujte adresu URL.
• 9408: Originový server vrátil stavový kód HTTP 4xx a pravděpodobně odepírá přístup k obrázku. Zkontrolujte nastavení obrázku a zkuste to znovu.
• 9509: Originový server vrátil stavový kód HTTP 5xx. Nejde pravděpodobně o problém se změnou velikosti, ale se softwarem na straně originového serveru.
• 9412: Originový server nevrátil obrázek, ale například stránku HTML. K tomu obvykle dochází, když je zadána neplatná adresa URL nebo když software na straně serveru vypíše chybu, případně zobrazí přihlašovací stránku.
• 9413: Obrázek přesahuje maximální plochu 100 megapixelů. Použijte menší obrázek a zkuste to znovu.
• 9420: Originový server přesměroval na neplatnou adresu URL. Zkontrolujte nastavení na svém originu a zkuste to znovu.
• 9421: Originový server přesměroval příliš mnohokrát. Zkontrolujte nastavení na svém originu a zkuste to znovu.
• 9422: Požadavek na transformaci byl odmítnut, protože byl dosažen limit využití. Pokud potřebujete požadovat více než 5,000 unikátních transformací, přejděte na placený plán Images.
• 9432: Images Binding není k dispozici při starším způsobu fakturace. Váš účet používá starší předplatné Image Resizing. Chcete-li propojit Images se svým Workerem, musíte v dashboardu přejít na předplatné Images.
• 9504, 9505 a 9510: Originový server se nepodařilo kontaktovat, protože může být nedostupný nebo přetížený. Zkuste to později.
• 9523: /cdn-cgi/image/ služba pro změnu velikosti nemohla velikost změnit. K tomu může dojít, když má obrázek neplatný formát. Použijte správně formátovaný obrázek a zkuste to znovu.
• 9524: /cdn-cgi/image/ služba pro změnu velikosti nemohla velikost změnit. K tomu může dojít, když URL adresu obrázku zachytí Worker. Jako alternativu můžete změnit velikost v rámci Workeru. K tomu může dojít také při použití pages.dev adresa URL Cloudflare Pages projektu. V takovém případě můžete použít Custom Domain místo toho.
• 9520: Formát obrázku není podporován. Více informací najdete v Podporované formáty a omezení kde se dozvíte o podporovaných vstupních a výstupních formátech.
• 9522: Obrázek překročil limit zpracování. K tomu může krátce docházet po vyčištění celé zóny nebo při požadavcích na soubory s velmi velkými rozměry. Pokud problém přetrvává, obraťte se na podporu.
• 9529: Při zpracování obrázku vypršel časový limit. K tomu může dojít při požadavcích na soubory s velmi velkými rozměry nebo když je server přetížený.
• 9424, 9516, 9517, 9518: Interní chyby. Pokud se s nimi setkáte, obraťte se na podporu.

Toto jsou limity pro obrázky uložené mimo Images:

• Maximální velikost obrázku je 100 megapixelů (například 10,000×10,000 pixelů). Maximální velikost souboru je 100 megabajtů (MB). Animace GIF/WebP jsou omezeny na celkem 50 megapixelů (součet velikostí všech snímků).
• Bring Your Own IP (BYOIP) není kompatibilní se službou Images při optimalizaci vzdálených obrázků (transformacích).
• Když Polish nedokáže optimalizovat obrázek, hlavička odpovědi Warning: cf-images 299 "original is smaller" se vrátí.

Požadavky na obrázky směrem k origin serveru budou anonymizovány (žádné cookies, žádná autentizace, žádné vlastní hlavičky). Je to proto, že pro obrázky se změněnou velikostí musíme mít jednu veřejnou mezipaměť, a nebylo by bezpečné sdílet obrázky personalizované pro jednotlivé návštěvníky.

V případech, kdy zákazníci souhlasí s ukládáním takových obrázků do veřejné mezipaměti, však Cloudflare umožňuje měnit velikost obrázků pomocí Workers u ověřených originů.

Změny rozměrů obrázku nebo dalších možností změny velikosti se projeví okamžitě, není potřeba nic vymazávat z mezipaměti.

Požadavek na obrázek se skládá ze dvou částí: spuštění kódu Workeru a zpracování obrázku. Kód Workeru se vždy spustí a neukládá se do mezipaměti. Výsledky zpracování obrázku se ukládají do mezipaměti po dobu jedné hodiny, případně déle, pokud hlavička origin serveru Cache-Control hlavička umožňuje. Zdrojový obrázek se ukládá do mezipaměti podle běžných pravidel ukládání do mezipaměti. Změna velikosti interně sleduje přesměrování, takže se do mezipaměti ukládají i přesměrování.

Protože odpovědi samotných Workers se na edge neukládají do mezipaměti, vymazání URL adresy Workerů nedělá nic. Varianty obrázků se změněnou velikostí se ukládají do mezipaměti společně pod adresou URL svého zdroje. Při čištění mezipaměti proto použijte adresu URL zdrojového obrázku (v plné velikosti), nikoli adresu URL Workeru, který o změnu velikosti požádal.

Pokud origin server odešle Etag hlavičku HTTP, budou mít upravené obrázky Etag hlavička HTTP, která má formát cf-<gibberish>:<etag of the original image>. Druhou část můžete porovnat s Etag hlavičku adresy URL zdrojového obrázku, aby ověřil, zda je obrázek se změněnou velikostí aktuální.