Mezipaměť stránek pro Odoo: obchod a blog z RAM nebo souboru – rychle pro návštěvníky, vyhledávače i AI

10. listopadu 2026  |  Vlastní vývoj  |  Odoo, výkon a vyhledávače

Webová stránka v Odoo vykresluje každou stránku při každém požadavku znovu: dotazy do databáze, šablony, překlady, ceny. U jednotlivého návštěvníka to není znát. Jakmile ale vyhledávače a AI indexery stahují stovky či tisíce stránek v mnoha jazycích, vzniká trvalá zátěž a čekají s nimi i skuteční zákazníci. Proto jsme vyvinuli modul pro Odoo 19 website_page_cache a zveřejnili jej na GitHubu jako Open Source (LGPL-3): anonymně vyvolané stránky obchodu a blogu se doručují téměř staticky z mezipaměti, buď ze souborů, nebo z operační paměti (RAM), a každá změna – i změna překladu – dotčené stránky z mezipaměti automaticky odstraní.

Důležité pro všechny, kdo chtějí být nalezeni: modul neblokuje žádný vyhledávač ani AI crawler. Všechny indexery dostanou stejný obsah jako každý návštěvník, jen rychleji. Tento článek vysvětluje, jak mezipaměť funguje, jak vypadá dashboard (se snímky obrazovky), jak poznáte, zda se vaše stránky vejdou do operační paměti a kolik RAM navíc by bylo potřeba, jaká bezpečnostní pravidla platí a jak modul nainstalovat.

Shrnutí

Problém: zátěž crawlerů na webech v Odoo

Odoo je kompletní ERP systém a web je jen jedním z mnoha modulů. Každá stránka, kterou vyvolá návštěvník nebo robot, projde stejnou cestou: zpracování požadavku, dotaz do databáze, načtení dat o produktech a cenách, vykreslení šablony QWeb, dosazení překladů a doručení výsledku. To trvá podle stránky několik set milisekund a po tu dobu je obsazen jeden z mála pracovních procesů.

Pro vyhledávače a AI indexery je to trvalé téma:

• Mnoho jazyků, mnoho adres: stránka, která existuje ve 46 jazycích, je pro crawler 46 různých adres.
• Každá adresa se stahuje zvlášť, často od mnoha rozptýlených odesílatelů současně. Klasická mezipaměť prohlížeče tu nepomůže, protože každý požadavek se týká nové adresy.
• Málo pracovních procesů: služba Odoo obvykle běží s hrstkou procesů. Jsou-li obsazeny požadavky crawlerů, skuteční návštěvníci čekají ve frontě.
• Stejný obsah, pořád znovu: článek na blogu se mění zřídka, ale při každém požadavku se náročně skládá znovu.

Nasnadě ležící východisko – crawlery vykázat – nepřipadá v úvahu pro firmu, která chce být nalezena. Viditelnost ve vyhledávačích a v odpovědích AI má hodnotu. Lepší je doručovat stránky tak rychle, aby na zátěži sotva záleželo. Přesně to mezipaměť stránek dělá.

Jak mezipaměť stránek funguje

Modul se zavěsí na vstup požadavků Odoo (ir.http). Při každém požadavku na stránku se v zlomku milisekundy rozhodne, zda smí stránka pocházet z mezipaměti, a pak ji doručí bez databáze, bez šablony a bez vykreslování.

1. Kontrola: v úvahu přichází pouze anonymní požadavek GET bez vyhledávacích parametrů na povolené cestě (obchod, kategorie, produkty, blog). Vše ostatní prochází Odoo jako vždy.
2. Klíč mezipaměti: skládá se z webu, třídy hostitele, jazyka, cesty, ceníku, fiskální pozice a stavu souhlasu s cookies. Návštěvníci, kteří by viděli něco jiného, tak nikdy nesdílejí jeden záznam. Hostitel se přitom normalizuje: Odoo píše absolutní adresy vždy z domény webu, nikoli z požadavku; adresa požadavku rozhoduje jen o tom, zda stránka platí za hlavní adresu (jazykové odkazy) a zda se má indexovat. Všechna cizí jména hostitelů proto sdílejí jeden záznam včetně upozornění noindex, místo aby každé zabíralo vlastní kopii.
3. Zásah: existuje-li aktuální záznam, doručí se. CSRF token ve stránce se přitom při každém požadavku nastaví znovu. Zobrazení článků blogu se nadále počítají.
4. Minutí: chybí-li záznam nebo je zastaralý, Odoo stránku vykreslí jako obvykle. Je-li výsledek vhodný pro mezipaměť (stav 200, HTML, žádné cookie, žádné ID relace v textu), uloží se; další požadavek je zásah.
5. Viditelné v hlavičce: každá odpověď nese hlavičku X-Page-Cache: HIT nebo MISS. Díky tomu lze libovolným nástrojem ověřit, co se stalo.

O kolik rychleji?

V našem testovacím systému (kopie našich webů, několik set stránek) byla průměrná doba vykreslení stránky zhruba 490 milisekund, doručení z mezipaměti zhruba 23 milisekund: přibližně dvacetkrát rychleji. Čím náročnější stránka, tím větší přínos. Dashboard z obou hodnot navíc vypočítá odhadovaný ušetřený čas serveru.

Soubor, nebo RAM: volba úložiště

Mezipaměť zná dvě úložiště. Obě jsou společně viditelná pro všechny pracovní procesy Odoo, takže každá stránka existuje jen jednou, nikoli jednou pro každý proces.

Pro většinu instalací je Automaticky správná volba: dostanete rychlost RAM, je-li místo, a jinak se bez zásahu vrátíte k souborům.

Vejde se web do operační paměti? A kolik RAM chybí?

Zda je mezipaměť v RAM možná, závisí na třech věcech: na počtu stránek, na jejich průměrné velikosti a na dostupné paměti. Dashboard to za vás spočítá:

• Počet stránek: pro každý web počítá publikované produkty, stránky seznamů obchodu, kategorie, články blogu a seznamy blogu a násobí počtem jazyků.
• Velikost stránky: jakmile jsou stránky v mezipaměti, měří se skutečný průměr; do té doby platí předpokládaná hodnota.
• Místo pro mezipaměť: nejmenší hodnota z nastaveného rozpočtu RAM, velikosti tmpfs a poloviny dostupné operační paměti. Server se nikdy nesmí kvůli mezipaměti dostat do nedostatku paměti.
• Posouzení: „vejde se s rezervou“, „těsně“, „příliš velké“ nebo „mezipaměť v RAM není k dispozici“. „Vejde se“ platí, když potřeba činí nejvýše 80 procent dostupného místa.

Nově: kolik RAM navíc by bylo potřeba?

Nevejde-li se mezipaměť, chce člověk vědět, co je třeba změnit. Dashboard proto pod posouzením uvádí konkrétní řádek: „RAM navíc pro mezipaměť v RAM: zhruba … více operační paměti na tomto serveru“ – nebo „žádná“, pokud místa už je dost. Je-li příliš malé nikoli samotný server, ale jen jedno nastavení, uvede se pod tím, které: rozpočet RAM modulu, nebo velikost tmpfs (/dev/shm).

Výpočet za tím je jednoduchý a srozumitelný:

1. Potřeba = stránky × průměrná velikost stránky.
2. S rezervou = potřeba dělená 0,8. Tato hodnota se musí vejít do rozpočtu RAM i do tmpfs, aby posouzení znělo „vejde se“.
3. Volná paměť: protože mezipaměť smí využít nejvýše polovinu dostupné operační paměti, potřebuje server jako volně dostupnou paměť alespoň dvojnásobek hodnoty z kroku 2. Chybí-li něco, rozdíl je potřebná RAM navíc.

Příklad na obrázku (12 000 stránek po 25 KB) je pomůcka pro výpočet, nikoli měření našich stránek. U malých webů stačí několik desítek megabajtů; ukázková data na snímcích obrazovky vystačila s asi 13 MB.

Důležité pro zařazení: odhad nepočítá další verze podle ceníků nebo zemí. Kdo jich používá hodně, naplánuje si nějakou rezervu. A ještě: příliš malý rozpočet RAM je nejčastějším důvodem, proč automatika zůstává u souborů – nikoli chybějící operační paměť. Dashboard v takovém případě zobrazí právě tento řádek.

Změny a překlady mezipaměť uklízejí

Mezipaměť je použitelná jen tehdy, když nikdy nedoručuje zastaralé stránky. Pouhý časový limit („zahazovat každých dvanáct hodin“) by byl příliš hrubý: změněná cena nebo opravený překlep by museli čekat až dvanáct hodin. Modul proto pracuje podle obsahu.

1. Databázové triggery: na všech tabulkách, které mohou stránku ovlivnit (produkty, varianty, obrázky, zásoby, atributy, kategorie, ceny, daně, ceníky, články blogu a štítky, data partnerů a firem, pohledy, assety, nabídky, jazyky, nastavení webu), sedí triggery PostgreSQL. Každou změnu zapisují do žurnálu změn.
2. Závislosti a stav databáze: každá stránka v mezipaměti si pamatuje, které záznamy zobrazuje, a stav databáze, s nímž vznikla.
3. Porovnání: existuje-li záznam v žurnálu, který vznikl po tomto stavu a týká se jednoho z těchto záznamů, je stránka zastaralá.
4. Nové uložení do mezipaměti: při dalším požadavku se zastaralá stránka zahodí, znovu se vykreslí a znovu uloží.

Pokryty jsou i překlady

Odoo 19 ukládá přeložené texty do téhož záznamu jako původní text (jako pole JSON). Změněný překlad je tedy pro databázi zcela běžná změna řádku – a trigger ji vidí. To platí stejně pro úpravy přes rozhraní, pro importy, pro rozhraní API i pro skripty, které zapisují přímo do databáze. Automatický překlad do 46 jazyků tak zneplatní přesně ty stránky, jejichž text se změnil, a nic víc.

• Cíleně místo plošně: změněný produkt zneplatní své stránky, seznamy, v nichž se nachází, a příslušnou kategorii. Zbytek zůstává v mezipaměti.
• Globální změny (šablony, assety, jazyky, nabídky, daně, měny) zneplatní vše najednou, protože se mohou týkat každé stránky.
• Počítadla zůstávají stranou: počítadlo zobrazení článků blogu se mění při každé návštěvě; záměrně nespouští zneplatnění, jinak by byla mezipaměť u oblíbených článků k ničemu.
• Pojistka: navíc existuje maximální stáří každé stránky (výchozí 12 hodin).
• Žádná chyba zápisu způsobená mezipamětí: chyba uvnitř triggeru se zaprotokoluje jako varování a vlastní uložení nenechá selhat.

Dashboard a statistiky

Vše, co potřebujete k provozu, je na jednom místě: v Odoo pod Web → Reporty → Mezipaměť stránek. Sekce Přehled je dashboard (s nastavením), sekce Průběh ukazuje čísla podle dne a webu.

Snímek obrazovky z testovacího systému s kopiemi našich webů; názvy webů byly nahrazeny zástupnými texty.

Nastavení

Stav a statistiky

Stav ukazuje aktivní úložiště včetně limitu, počet a velikost stránek v mezipaměti a sledování změn: kolik změn bylo zaregistrováno za posledních 24 hodin a kolik tabulek se sleduje. Chybí-li některé sledování, dashboard zřetelně varuje, protože pak se mezipaměti nesmí věřit. Tlačítka nahoře umožňují okamžitě spustit údržbu, vyprázdnit mezipaměť nebo zkontrolovat triggery a v případě potřeby je znovu vytvořit.

Statistiky (Dnes, 7 dní, 30 dní) obsahují:

• Z mezipaměti a Vykresleno: zásahy a minutí, z toho úspěšnost zásahů
• Odstraněno (změněno/vypršelo): kolik stránek bylo zahozeno kvůli změně nebo vypršení
• Doba vykreslení a doba z mezipaměti: průměr na stránku ve srovnání
• Odhadovaný ušetřený čas serveru a objem dat z mezipaměti

Čísla sbírá každý pracovní proces zvlášť a zapisuje je jednou za minutu; řádky starší než 90 dní uklidí údržbová úloha.

Průběh jako graf, kontingenční tabulka a seznam

Pod Průběh jsou k dispozici denní hodnoty podle webu – jako graf, kontingenční tabulka nebo seznam. Uvidíte tak, zda úspěšnost zásahů po restartu nebo po velké změně opět stoupá a který web získává z mezipaměti nejvíce provozu.

Bezpečnost: co nikdy nepochází z mezipaměti

Mezipaměť stránek nikdy nesmí vést k tomu, aby někdo viděl obsah někoho jiného. Modul proto postupuje podle zásady: v pochybnostech neukládat.

• Pouze anonymní návštěvníci: kdo je přihlášen, má košík nebo nese jiný stav relace, dostane vždy normálně vykreslenou stránku.
• Pouze GET bez vyhledávacích parametrů: vyhledávání, filtry, řazení, formuláře, košík a pokladna zůstávají nedotčeny.
• Pouze stav 200 a HTML: chybové stránky, přesměrování a soubory se neukládají.
• Žádná ID relací v mezipaměti: stránka, která obsahuje ID relace nebo nastavuje cookie, se neuloží (a zaprotokoluje se jako varování).
• CSRF token pro každý požadavek: token v uložené stránce je zástupný znak a při každém doručení se dosadí znovu.
• Jemný klíč: web, jazyk, ceník, fiskální pozice a souhlas s cookies patří do klíče mezipaměti; kdo vidí něco jiného, dostane jiný záznam.
• Více databází: každá databáze má vlastní záznamy, vlastní žurnál a vlastní statistiky.
• Žádný únik dat: mezipaměť leží lokálně na serveru (soubor nebo RAM). Žádná data se nepřenášejí třetím stranám.

Vyhledávače a AI indexery: nic se neblokuje

Někteří provozovatelé reagují na zátěž crawlerů blokacemi. To chrání server, ale stojí to viditelnost. Modul volí opačnou cestu:

• Stejný obsah pro všechny: vyhledávače, AI indexery i návštěvníci dostanou stejnou stránku. Neexistuje žádná zvláštní „verze pro crawlery“ ani rozpoznávání podle identifikace prohlížeče.
• Rychlejší odpovědi pomáhají indexaci: stránka, která odpoví za 20 místo 500 milisekund, méně zatěžuje crawl budget a crawlery mohou za stejnou dobu zachytit více stránek.
• Aktuální obsah: protože změny stránky okamžitě zneplatní, crawlery nikdy neuvidí zastaralou verzi – důležité, pokud udržujete obsah pro vyhledávání a odpovědi AI.
• Strukturovaná data zůstávají zachována: JSON-LD, meta údaje a odkazy hreflang jsou součástí uložené stránky; sitemapy a soubory mezipaměť nechává na pokoji.

Chcete-li navíc omezit zátěž, jde o samostatné rozhodnutí, které můžete učinit vědomě – modul vám je nevnucuje.

Minimalizace HTML a komprimované doručování

Mezipaměť šetří nejen výpočetní čas, ale i objem dat. Modul HTML před uložením minimalizuje a doručuje je komprimované, pokud to prohlížeč nebo crawler nabízí:

• Minimalizace (parametr website_page_cache.minify): HTML komentáře odpadají, bílé znaky se slučují. Zcela se odstraňují jen tam, kde je prohlížeč stejně ignoruje, například mezi blokovými prvky. Mezery mezi řádkovými prvky zůstávají, pre, textarea a skripty zůstávají beze změny, strukturovaná data (JSON-LD) se přepisují kompaktně. Podle stránky jsou stránky o 10 až 30 % menší. Při testu se sedmi skutečnými stránkami byly text, počet prvků, poloha všech prvků a snímek obrazovky shodné s originálem. První doručení (MISS) je minimalizováno stejně jako každé další (HIT).
• Komprese (parametr website_page_cache.compress): stránky z mezipaměti odcházejí přes gzip (Content-Encoding: gzip, Vary: Accept-Encoding). Velké balíky assetů (CSS a JavaScript, až několik MB) Odoo samo doručuje nekomprimované; modul je jednou zkomprimuje, kopii uloží na disk a poté je doručuje přímo. Z 2,1 MB CSS tak bylo 0,27 MB, ze 4,8 MB JavaScriptu 1,1 MB. Staré kopie uklidí údržbová úloha.
• Po restartu počítače: mezipaměť v RAM přežije restarty Odoo, nikoli však restart serveru. Proto ji údržbová úloha postupně zrcadlí na disk (parametr website_page_cache.persist) a při startu obnoví. Zda je obnovený záznam stále platný, kontroluje stejný mechanismus jako jindy: stáří a žurnál změn. Minimalizace se přitom nepřepočítává.

Instalace a nastavení

1. Získat modul: stáhněte zdrojový kód z GitHubu a umístěte jej do cesty addonů vaší instalace Odoo 19: github.com/Alex0176/odoo-website-page-cache
2. Nainstalovat: odoo-bin -d <Datenbank> -i website_page_cache --stop-after-init. Vznikne přitom žurnál změn, triggery a údržbová úloha (každých 10 minut).
3. Restartovat službu, aby modul načetly všechny pracovní procesy.
4. Otevřít dashboard: Web → Reporty → Mezipaměť stránek. Zkontrolovat, zda je sledování změn úplné, a zvolit úložiště (výchozí: automaticky).
5. Ověřit: stránku obchodu nebo blogu vyvolat dvakrát a podívat se na hlavičku X-Page-Cache: poprvé MISS, poté HIT.

Nastavení jsou uložena jako systémové parametry (website_page_cache.enabled, .backend, .ttl_hours, .max_mb_file, .max_mb_ram) a obvykle se spravují v dashboardu. Modul je přeložen do němčiny. Odinstalování opět zcela odstraní triggery, žurnál i všechny uložené stránky.

Tip pro mezipaměť v RAM: rozpočet RAM v dashboardu a velikost tmpfs (/dev/shm, přípojná volba size=) musí odpovídat potřebě. Obojí vám sdělí kontrola „Vejde se to do operační paměti?“ s konkrétními hodnotami.

Omezení, která byste měli znát

• Krátké zpoždění po změnách: index žurnálu změn se obnovuje každé dvě sekundy. Do té doby může být změněná stránka ještě doručena ve staré verzi.
• Texty závislé na skladu se aktualizují prostřednictvím změn zásob a maximálního stáří.
• Odhad potřebného místa: další verze podle ceníku nebo země nejsou zahrnuty; počítejte s určitou rezervou.
• Není náhradou za všechno: mezipaměť odlehčuje požadavkům, které smí obsloužit. Přihlášení uživatelé, vyhledávání a formuláře nadále procházejí Odoo.
• První požadavek zůstává pomalý: po restartu serveru (RAM) nebo globální změně se každá stránka jednou normálně vykreslí, než se dostane do mezipaměti.

Časté dotazy

Co je mezipaměť stránek pro Odoo?

Open-source modul (website_page_cache, Odoo 19, LGPL-3), který veřejné stránky obchodu a blogu doručuje anonymním návštěvníkům z mezipaměti, místo aby je při každém požadavku vykresloval znovu. Mezipaměť leží podle volby v souborech nebo v operační paměti.

Blokuje modul vyhledávače nebo AI crawlery?

Ne. Vyhledávače a AI indexery dostávají stejné stránky jako každý jiný návštěvník, jen rychleji. Neexistuje žádná blokace, žádné omezování rychlosti ani zvláštní verze pro crawlery.

Ukládají se změněné stránky a překlady do mezipaměti automaticky znovu?

Ano. Triggery PostgreSQL hlásí každou změnu relevantních tabulek do žurnálu; dotčené stránky se zahodí a při dalším požadavku se znovu vykreslí a uloží. Překlady jsou pokryty, protože je Odoo 19 ukládá do téhož záznamu.

Mám zvolit soubor, nebo RAM?

Zpravidla Automaticky: modul využívá RAM, dokud se všechny stránky vejdou, a jinak ustoupí k souborům. Soubory se hodí, má-li mezipaměť přežít restarty nebo je-li RAM málo; RAM je nejrychlejší varianta.

Jak zjistím, zda se můj web vejde do operační paměti?

V dashboardu pod Web → Reporty → Mezipaměť stránek. Sekce „Vejde se to do operační paměti?“ počítá stránky podle webu a jazyka, měří velikost stránky a porovnává potřebu s rozpočtem RAM, velikostí tmpfs a dostupnou pamětí.

Kolik RAM navíc je pro mezipaměť v RAM potřeba?

Dashboard to uvádí na samostatném řádku. Počítá se: potřeba = stránky × velikost stránky; s bezpečnostní rezervou dělené 0,8. Protože mezipaměť smí využít nejvýše polovinu dostupné paměti, je dvojnásobek tohoto čísla potřebná volná paměť; rozdíl je RAM navíc. Je-li příliš malý jen rozpočet RAM nebo tmpfs, dashboard uvede nastavení včetně cílové hodnoty.

Může mezipaměť někomu ukázat cizí obsah?

Ne. Do mezipaměti se ukládá jen pro anonymní požadavky GET bez vyhledávacích parametrů. Přihlášení uživatelé, košíky, formuláře a vyhledávání nikdy nepocházejí z mezipaměti; jazyk, ceník, fiskální pozice a souhlas s cookies jsou součástí klíče.

Jak v nouzi mezipaměť vypnu?

V dashboardu vypněte přepínač „Aktivní“ nebo nastavte systémový parametr website_page_cache.enabled na 0. Platí to ve všech pracovních procesech nejpozději po 30 sekundách. Odinstalování navíc odstraní triggery, žurnál i uložené stránky.

Jak poznám, že stránka pochází z mezipaměti?

Podle hlavičky odpovědi X-Page-Cache: HIT znamená z mezipaměti, MISS znamená čerstvě vykresleno a uloženo.

Zmenšuje modul HTML a komprimuje je?

Ano. Stránky v mezipaměti se konzervativně minimalizují (komentáře a nadbytečné bílé znaky odpadají, obsah a vzhled zůstávají stejné) a při zásazích mezipaměti se doručují přes gzip; balíky assetů se jednou zkomprimují a doručují z disku. Obojí lze vypnout parametry website_page_cache.minify a website_page_cache.compress.

Podpora od Biricon IT Services

Váš web v Odoo reaguje při zátěži crawlerů pomalu, nebo chcete obchod a blog zrychlit a zviditelnit? Podporujeme vás při analýze zátěže, při zavedení mezipaměti stránek, při dimenzování operační paměti a pracovních procesů a při vícejazyčné optimalizaci pro vyhledávače vašeho webu v Odoo. Zdrojový kód modulu najdete na GitHubu.

Kontaktujte nás nyní

Stav: 10. listopadu 2026. Naměřené hodnoty pocházejí z testovacího systému s ukázkovými daty a nejsou příslibem pro jiné instalace.