Przejdź do głównej treści
Ayakaleaf Pro działa na serwerze z 2 rdzeniami CPU i 2 GB pamięci, łącznie z integracją Git, gdy dodasz 2 GB swapu. Bez swapu zabraknie mu pamięci podczas uruchamiania. Ustawienia z kroku 2 zmniejszają następnie użycie swapu prawie o połowę.
Zmierzyliśmy to na Ayakaleaf Pro 6.3.1 z Toolkitem, w maszynie wirtualnej QEMU/KVM z 2 vCPU / 2 GiB działającej pod Ubuntu 24.04, z włączoną kompilacją w piaskownicy (texlive-basic:2025.1) i integracją Git.

Dlaczego domyślnie 2 GB nie wystarczają

W stanie bezczynności, przy ustawieniach domyślnych, Ayakaleaf Pro potrzebuje około 1,9 GiB. Ubuntu i Docker zajmują już 364 MiB maszyny z 2 GiB, co pozostawia około 1600 MiB.

  1. Dodaj 2 GB swapu

To najważniejszy krok.

  1. Zmniejsz użycie pamięci

Dodaj te wiersze do config/variables.env. Kontener integracji Git również odczytuje ten plik.
variables.env
Aby ograniczyć pamięć podręczną MongoDB, dodaj wpis mongo w sekcji services w pliku config/docker-compose.override.yml (tym samym, który ustawia obraz Ayakaleaf Pro):
docker-compose.override.yml
Następnie uruchom bin/up -d.
NODE_OPTIONS zastępuje wartość ustawioną w obrazie, więc wiersz musi zachować --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs. Bez nich usługi Node.js nie mogą załadować swoich pakietów i się nie uruchamiają. Nie można użyć --optimize-for-size: Node.js odrzuca tę opcję w NODE_OPTIONS.--replSet overleaf to wartość, którą Toolkit domyślnie przekazuje do MongoDB. Zachowaj ją.
Przy stercie 160 MiB klonowanie lub wypychanie dużego projektu przez Git może wyczerpać pamięć, a kontener integracji Git zostanie ponownie uruchomiony. Nie testowaliśmy tego. Jeśli tak się stanie, zwiększ -Xmx.

Wyniki

Każdy test kompilował 33-stronicowy dokument LuaLaTeX z fontspec i 30 rysunkami TikZ; równoczesne kompilacje dotyczyły różnych projektów. Bez swapu jedno zabicie z powodu braku pamięci prowadzi do kolejnego: web uruchamia się ponownie, jego start znowu wymaga pamięci, a serwer zawiesza się aż do twardego resetu. Ze swapem trzy jednoczesne kompilacje trwają mniej więcej tyle co jedna, ponieważ do swapu trafiają nieaktywne strony Node.js. Nie testowano: obciążenia przez klonowanie i wypychanie w Git, wielu użytkowników edytujących jednocześnie oraz swapu na wolnych dyskach (nasz host używał dysku SSD).

Kubernetes

Nasz przewodnik po Kubernetes wyłącza swap na węzłach (Przygotuj węzły), więc tam ma zastosowanie tylko krok 2. Umieść NODE_OPTIONS i MALLOC_ARENA_MAX w ConfigMap overleaf-env (Personalizacja instancji). Pamięć podręczna MongoDB jest już ustawiona w Wdróż MongoDB i Redis.
Ostatnia modyfikacja 21 listopada 2026