메인 콘텐츠로 건너뛰기
2 GB의 스왑을 추가하면 Ayakaleaf Pro는 Git 연동을 포함해 CPU 코어 2개, 메모리 2 GB인 서버에서 실행됩니다. 스왑이 없으면 시작하는 동안 메모리가 부족해집니다. 2단계의 설정을 적용하면 스왑 사용량을 거의 절반으로 줄일 수 있습니다.
이 측정은 Ubuntu 24.04를 실행하는 2 vCPU / 2 GiB QEMU/KVM 가상 머신에서 Toolkit으로 설치한 Ayakaleaf Pro 6.3.1을 대상으로, 샌드박스 컴파일(texlive-basic:2025.1)과 Git 연동을 켠 상태로 수행했습니다.

기본 설정에서 2 GB가 부족한 이유

기본 설정에서 Ayakaleaf Pro는 유휴 상태일 때 약 1.9 GiB가 필요합니다. 2 GiB 머신에서 Ubuntu와 Docker가 이미 364 MiB를 사용하므로 약 1600 MiB만 남습니다.

  1. 2 GB 스왑 추가

가장 중요한 단계입니다.

  1. 메모리 사용량 줄이기

다음 줄을 config/variables.env에 추가합니다. Git 연동 컨테이너도 이 파일을 읽습니다.
variables.env
MongoDB 캐시를 제한하려면 config/docker-compose.override.yml(Ayakaleaf Pro 이미지를 설정하는 파일과 같은 파일)의 services 아래에 mongo 항목을 추가합니다.
docker-compose.override.yml
그런 다음 bin/up -d를 실행합니다.
NODE_OPTIONS는 이미지에 설정된 값을 대체하므로 이 줄에는 반드시 --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs가 남아 있어야 합니다. 이것이 없으면 Node.js 서비스가 패키지를 불러오지 못해 시작되지 않습니다. --optimize-for-size는 사용할 수 없습니다. Node.js가 NODE_OPTIONS에서 이 옵션을 거부합니다.--replSet overleaf는 Toolkit이 기본적으로 MongoDB에 전달하는 값입니다. 그대로 두세요.
힙이 160 MiB이면 큰 프로젝트를 Git으로 클론하거나 푸시할 때 메모리가 부족해져 Git 연동 컨테이너가 재시작될 수 있습니다. 이 경우는 테스트하지 않았습니다. 이런 일이 발생하면 -Xmx를 높이세요.

결과

각 테스트에서는 fontspec과 TikZ 그림 30개가 포함된 33쪽 분량의 LuaLaTeX 문서를 컴파일했습니다. 동시 컴파일에는 서로 다른 프로젝트를 사용했습니다. 스왑이 없으면 메모리 부족으로 인한 종료가 연쇄적으로 일어납니다. web이 재시작되고, 시작하는 데 다시 메모리가 필요해지며, 하드 리셋할 때까지 서버가 멈춥니다. 스왑이 있으면 동시에 세 번 컴파일해도 한 번 컴파일할 때와 거의 같은 시간이 걸립니다. 스왑으로 밀려나는 것은 유휴 상태의 Node.js 페이지이기 때문입니다. 테스트하지 않은 항목: Git 클론 및 푸시 부하, 많은 사용자의 동시 편집, 느린 디스크에서의 스왑(테스트 호스트는 SSD를 사용했습니다).

Kubernetes

Kubernetes 가이드에서는 노드의 스왑을 끄므로(노드 준비) 여기서는 2단계만 적용됩니다. NODE_OPTIONS와 MALLOC_ARENA_MAX는 overleaf-env ConfigMap에 넣으세요(인스턴스 개인화). MongoDB 캐시는 이미 MongoDB 및 Redis 배포에서 설정되어 있습니다.
마지막 수정일 2026년 11월 21일