Jak cachovat OG obrázky

Cachování OG obrázků znamená doručování dříve vygenerovaného sociálního náhledu z CDN místo jeho opětovného vykreslování při každém sdílení. FastOG cachuje identické obrázky na okraji sítě po dobu jednoho roku – stejná URL vrací cachovaný PNG bez započítání do vaší kvóty a s téměř nulovou latencí, takže většina OG provozu webu se nikdy nedotkne rendereru.

Proč je ukládání do mezipaměti důležité

Sdílení na sociálních sítích spustí načtení stránky crawlerem dané platformy. Pokud by se každé sdílení znovu vykreslovalo, plýtvali byste kvótou a latencí na identický obsah. Agresivní ukládání do mezipaměti (caching) – klíčované podle obsahu obrázku – mění „každé sdílení stojí 1 vykreslení" na „první sdílení stojí 1 vykreslení, každé další sdílení je zdarma."

Obsahově klíčovaný model, díky kterému to funguje

FastOG používá URL podepsané obsahem: URL je čistou funkcí parametrů. Stejný titulek + stejná šablona → stejná URL. To znamená:

Edge FastOG uchovává obrázek pod touto URL.
Stejný obsah sdílený 10 000krát → jedno vykreslení, jedno započtení kvóty, 9 999 zásahů do cache.
Změna obsahu → jiná URL → jedno nové vykreslení.

GET /api/v1/og?title=Hello&template=default&key=...&s=...   → render (1 quota count), then
GET /api/v1/og?title=Hello&template=default&key=...&s=...   → cached (0 counts, instant)
GET /api/v1/og?title=Changed&template=default&key=...&s=... → render (1 quota count)

Vyrovnávací hlavičky FastOG

FastOG vrací Cache-Control: public, max-age=31536000, immutable (jeden rok) pro vykreslené obrázky. Cover je obsluhován z FastOG edge ve dvou vrstvách: vyrovnávací paměť renderu před fastog.com a trvalé úložiště objektů za ní. Opakované požadavky jsou obslouženy bez nového vykreslení a X-FastOG-Worker-Cache v odpovědi říká, která vrstva odpověděla (HIT, R2, MISS).

Protože trvalá kopie nezávisí na rendereru, covery, které byly načteny alespoň jednou, jsou nadále obsluhovány, i když je renderovací služba FastOG krátce nedostupná — výpadek nezpůsobí prázdný náhled u již vygenerovaného obrázku. Cover, který ještě nikdy nebyl vykreslen, je jediný případ, kdy je renderer potřeba, a zde FastOG odpovídá obrázkem, nikoli chybou:

Situace	Co crawler dostane
Cover již vykreslen	cover z edge nebo z trvalého úložiště
Nikdy nevykreslen, renderovací služba běží	cover vykreslený na vyžádání
Nikdy nevykreslen, renderovací služba krátce nedostupná	vlastní obrázek stránky nesený v URL (váš produktový obrázek), nebo neutrální karta — nikdy chybová stránka

Pokud je samotný požadavek neplatný (zfalšovaný podpis, chybějící title), stále dostanete odpovídající 4xx.

Změna již publikovaného obrázku

Co jste změnili	Co dělat
Obsah (název, cena, fotka)	nic: obsah je v URL, takže nový obsah znamená novou URL a vykreslí se čerstvě
Šablonu nebo výchozí nastavení renderu	zvyšte verzi pro obcházení cache (`FASTOG_CACHE_BUST`), aby každá URL získala nový parametr `v`
Potřebujete překreslit stejnou URL	požádejte podporu o pročištění této jedné URL — pročištění přesné URL není vystaveno jako veřejný endpoint

Odkazy, které už byly sdíleny, nadále fungují a zobrazují obrázek, který slibovaly, dokud nepročistíte přesně tuto URL.

Cacheování vlastního og:image (self-hosted)

Pokud ukládáte obrázky sami místo použití FastOG cache, použijte stejná pravidla:

Krok	Detail
Cache klíč = hash obsahu	Ukládejte podle hashe dat, ne podle proměnlivého názvu souboru
Dlouhé TTL	`max-age=31536000, immutable` pro stabilní obsah
Verzované URL	Přidejte hash/verzi při změně obsahu
CDN vpředu	Nechte CDN absorbovat opakované požadavky

FAQ

Skutečně stojí opakované sdílení 0 renderů?

Ano. Identické URL zasáhnou edge cache a nikdy se nedostanou k rendereru — nespotřebovává se žádný kvótový počet.

Jak dlouho FastOG ukládá obrázek do mezipaměti?

Jeden rok (immutable). Dlouho po prvním renderu je sdílená karta obsluhována z mezipaměti.

Co když chci, aby se obrázek aktualizoval (např. živá cena)?

Změňte parametr (cenu) → nová URL → nový render. Stabilní obsah zůstává v mezipaměti; dynamický obsah se aktualizuje, když chcete.