Vyšší zabezpečení
Sandboxed Compiles jsou pro Ayakaleaf Pro doporučeným přístupem, protože mnoho dokumentů LaTeX vyžaduje (nebo má) možnost spouštět v rámci procesu kompilace PDF libovolné shellové příkazy. Pokud používáte Sandboxed Compiles, každá kompilace běží v samostatném Docker kontejneru s omezenými schopnostmi, který není sdílen s žádným jiným uživatelem ani projektem a nemá přístup k vnějším prostředkům, jako je síť hostitele.Snadnější správa balíčků
Abyste nemuseli balíčky instalovat ručně, doporučujeme povolit Sandboxed Compiles. Jde o konfigurovatelné nastavení v Ayakaleaf Pro, které vašim uživatelům poskytne přístup ke stejnému prostředí TeX Live jako na overleaf.com, ale v rámci vaší vlastní on-premise instalace. Image TeX Live používané Sandboxed Compiles obsahují nejoblíbenější balíčky a fonty otestované proti šablonám z naší galerie, což zajišťuje maximální kompatibilitu s on-premise projekty. Povolení Sandboxed Compiles vám umožní nakonfigurovat, ze kterých verzí TeX Live si uživatelé mohou v projektu vybírat, a nastavit výchozí verzi image TeX Live pro nové projekty.Pokud se pokusíte provozovat Ayakaleaf Pro bez Sandboxed Compiles, vaše instance bude ve výchozím stavu ke kompilaci používat verzi TeX Live se schématem basic. Tato základní verze je odlehčená a obsahuje jen velmi omezenou podmnožinu balíčků LaTeX, což u vašich uživatelů nejspíše povede k chybám kvůli chybějícím balíčkům, zejména pokud se pokusí použít předpřipravené šablony.
Sandboxed Compiles vyžadují, aby kontejner
sharelatex měl přístup k Docker socketu na hostitelském stroji (přes bind mount), aby mohl spravovat tyto sourozenecké kompilační kontejnery.Jak to funguje
Když jsou Sandboxed Compiles povoleny, Docker socket z hostitelského stroje se připojí do kontejnerusharelatex, takže kompilační služba v kontejneru může na hostiteli vytvářet nové Docker kontejnery. Poté při každém spuštění kompilátoru v každém projektu provede kompilační služba LaTeXu (CLSI) následující:
- Zapíše soubory projektu do umístění uvnitř
OVERLEAF_DATA_PATH. - Pomocí připojeného Docker socketu vytvoří pro daný běh kompilace nový kontejner
texlive. - Kontejner
texlivenačte data projektu z umístění podOVERLEAF_DATA_PATH. - Zkompiluje projekt uvnitř kontejneru
texlive.
Povolení Sandboxed Compiles
Pro uživatele Toolkitu
Chcete-li povolit sandboxové kompilace (známé také jako sourozenecké kontejnery, Sibling containers), nastavte voverleaf-toolkit/config/overleaf.rc následující konfigurační volby:
config/overleaf.rc
SIBLING_CONTAINERS_ENABLED=false a spusťte bin/up. Kompilace pak běží uvnitř kontejneru sharelatex s jeho základním TeX Live.
Pro uživatele Docker Compose
Nastavení image TeX Live
Uživatelé z pevninské Číny mohou pro zrychlení stahování stáhnout image ze zrcadla NEPOUŽÍVEJTE
ghcr.nju.edu.cn a poté je otagovat jejich názvem z ghcr.io:ghcr.nju.edu.cn v nastavení prostředí toolkitu: ponechte tam názvy z ghcr.io. Aby bin/up znovu nestahoval image z ghcr.io, nastavte v config/overleaf.rc SIBLING_CONTAINERS_PULL=false. Jak udržovat image aktuální přes zrcadlo, popisuje Automatická aktualizace image TeX Live Full.TEX_LIVE_DOCKER_IMAGE(volitelné): Image TeX Live používaný novými projekty. Musí jít o jeden z image uvedených vALL_TEX_LIVE_DOCKER_IMAGES. Pokud není nastaven, nové projekty použijí první image zALL_TEX_LIVE_DOCKER_IMAGES.ALL_TEX_LIVE_DOCKER_IMAGE_NAMES(volitelné): Čárkami oddělený seznam názvů image ve stejném pořadí, zobrazovaných v nastavení kompilátoru. Pokud není nastaven nebo je kratší než seznam image, zobrazí se image podle svého tagu, například2026.1.ALL_TEX_LIVE_DOCKER_IMAGES(povinné): Čárkami oddělený seznam image TeX Live, které se mají použít. Pokud se k nasazení používá Overleaf Toolkit, tyto image budou staženy nebo aktualizovány. Chcete-li stahování přeskočit, nastavte vconfig/overleaf.rchodnotuSIBLING_CONTAINERS_PULL=false.
bin/up Toolkit automaticky stáhne všechny image uvedené v ALL_TEX_LIVE_DOCKER_IMAGES.
Zde je příklad, kde je pro nové projekty výchozí TeX Live 2026 a pro staré projekty se nadále používá verze 2025.
- Minimální instalace
- Úplná instalace
Následující konfigurace nainstaluje všechny úplné Docker image TeX Live od roku 2025 do roku 2026. Před použitím této konfigurace doporučujeme mít k dispozici alespoň 64 GB volného úložiště.
config/variables.env
Důrazně doporučujeme nastavit alespoň 2 image texlive-full. Podrobné zdůvodnění najdete v #known-issues
Dostupné image TeX Live
Toto je řada image TeX Live speciálně optimalizovaných pro Overleaf, které lze také přidat doTEX_LIVE_DOCKER_IMAGE a ALL_TEX_LIVE_DOCKER_IMAGES:
ghcr.io/ayaka-notes/texlive-full:2026.1(také taglatest)ghcr.io/ayaka-notes/texlive-full:2025.1ghcr.io/ayaka-notes/texlive-full:2024.1ghcr.io/ayaka-notes/texlive-full:2023.1ghcr.io/ayaka-notes/texlive-full:2022.1ghcr.io/ayaka-notes/texlive-full:2021.1ghcr.io/ayaka-notes/texlive-full:2020.1
Mohu použít jiný registr image?
Někteří se mohou ptát, zda lze nahradit ghcr.io jiným zrcadlem nebo přepnout texlive na jiný image z Docker Hubu.
Ne, nedoporučujeme to, protože konfigurace je poměrně složitá. Pokud stahujete ze zrcadla, můžete svůj image přejmenovat na ghcr.io/ayaka-notes/texlive-full.
Pokud ale opravdu chcete používat vlastní registr image, přidejte:
config/variables.env
your-repo, například
hub.your.com/your-repo/texlive-full:2025.1hub.your.com/your-repo/texlive-full:2024.1
sandboxed-compiles/index.mjs
Automatická synchronizace image TeX Live
Abyste nemuseli instanci pokaždé ručně aktualizovat pomocíbin/up, můžete aktualizace image TeX Live automatizovat. Viz updating-tex-live-full-images-automatically.md.
Známé problémy
Toto je skutečný případ z komunity Overleafu:Používám6.0.1-ext-v3.3a vvariables.envmám tato nastavení:Stexlive/texlive:latest-fullto funguje dobře. Stáhl jsem si však jiný image texlivedanteev/texlive:2025-10-15a obě tyto proměnné jsem změnil na název nového image, ale nefunguje to:V logech vidím následující:
Zdá se, že aktualizovaná nastavení veKvůli určitým technickým omezením: pokud nastavíte pouze jeden Docker image TeXLive, napříkladvariables.envse neprojevují. Kompilace se stále pokouší spustit imagetexlive/texlive:latest-full, nikoli nový image. Zkoušel jsem restartovat, smazat kontejnery a znovu je spustit, ale problém přetrvává. Máte nějaké řešení?
texlive-fullA:latest
texlive-fullB:latest, zjistíte, že vaši uživatelé nemohou zkompilovat žádné projekty.
Ladění a hlášení problémů
Spusťte následující příkaz pro kontrolu logu clsi z toolkitu:Otázky a odpovědi
Odstraňují se kontejnery sandboxu, soubory kompilace a image TeX Live automaticky?
Odstraňují se kontejnery sandboxu, soubory kompilace a image TeX Live automaticky?
Odpověď: Kontejnery a soubory kompilace ano, s určitým zpožděním; image TeX Live ne.
- Kontejnery kompilace (
project-<project id>-<hash>) se znovu používají pro další kompilace téhož projektu, takže po kompilaci zůstávají. Každou hodinu běží kontrola, která odstraní ty, které jsou starší než jedna hodina a jejichž projekt nebyl v poslední hodině kompilován. Kontejner obvykle zmizí jednu až dvě hodiny po poslední kompilaci. Restart Overleafu je neodstraní; odstraní je až další hodinová kontrola. - Kontejnery pro počítání slov, SyncTeX a konverze se odstraní, jakmile skončí.
- Soubory kompilace (
data/overleaf/data/compilesaoutput) se odstraní, jakmile projekt není jeden den používán; kontroluje se to každých 10 minut. Když dochází místo na disku, tato doba se postupně zkracuje až na půl dne. - Image TeX Live se nikdy neodstraňují, protože je potřebuje každá kompilace. Chcete-li po odebrání image z
ALL_TEX_LIVE_DOCKER_IMAGESuvolnit místo, smažte jej pomocídocker image rm <image>.
Může projekt číst soubory z adresáře na hostiteli nebo na NAS?
Může projekt číst soubory z adresáře na hostiteli nebo na NAS?
Odpověď: Ne. Každý kontejner kompilace připojuje pouze adresář kompilace vlastního projektu, a to do
/compile, nemá přístup k síti a neexistuje žádné nastavení, kterým by do něj bylo možné připojit jiné adresáře hostitele. Soubory, které projekt potřebuje, místo toho nahrajte do projektu.Existuje základní (basic) image TeX Live a jak jej nakonfiguruji?
Existuje základní (basic) image TeX Live a jak jej nakonfiguruji?
Odpověď: Ano.
ghcr.io/ayaka-notes/texlive-basic:<year>.1 (2020.1 až 2026.1) obsahuje schéma TeX Live basic a několik dalších balíčků, například latexmk, xetex a fontspec, bez kompletní sady písem. Je mnohem menší než texlive-full, ale projekty, které používají jiné balíčky, skončí chybami kvůli chybějícím balíčkům. Pro TeX Live 2025 basic:config/variables.env
ghcr.io/ayaka-notes/texlive-full:base není základní image: neobsahuje TeX Live a nedokáže kompilovat.Kde zjistím, jak dlouho kompilace trvala?
Kde zjistím, jak dlouho kompilace trvala?
Odpověď: Editor to nezobrazuje a log
clsi to zaznamenává pouze na úrovni debug. Každý požadavek na kompilaci však tuto informaci vrací: otevřete vývojářské nástroje prohlížeče, přejděte na kartu Network, spusťte znovu kompilaci a vyberte požadavek compile. Jeho JSON odpověď obsahuje timings v milisekundách, kde compileE2E je celá kompilace v kompilační službě a compile je samotný běh LaTeXu.
