跳转到主要内容
添加 2 GB 交换空间(swap)后,Ayakaleaf Pro 可以在 2 个 CPU 核心、2 GB 内存的服务器上运行,包括 Git 集成。没有交换空间时,它会在启动过程中耗尽内存。第 2 步中的设置还能将交换空间的使用量减少近一半。
我们在 Ayakaleaf Pro 6.3.1 上使用 Toolkit 进行了测量,环境为运行 Ubuntu 24.04 的 2 vCPU / 2 GiB QEMU/KVM 虚拟机,开启了沙盒编译(texlive-basic:2025.1)和 Git 集成。

为什么默认情况下 2 GB 不够用

在默认设置下,Ayakaleaf Pro 空闲时大约需要 1.9 GiB。Ubuntu 和 Docker 已经占用了 2 GiB 机器中的 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。

结果

每次测试都编译一个 33 页的 LuaLaTeX 文档,使用 fontspec 和 30 个 TikZ 图形;并发编译使用的是不同的项目。 没有交换空间时,一次内存不足终止会引发下一次:web 重启,启动又需要内存,服务器会一直挂起,直到硬重置。有交换空间时,同时进行三次编译所需时间与一次编译差不多,因为被换出到交换空间的是空闲的 Node.js 内存页。 未测试:Git 克隆和推送负载、大量用户同时编辑,以及慢速磁盘上的交换空间(我们的主机使用的是 SSD)。

Kubernetes

我们的 Kubernetes 指南会在节点上关闭交换空间(准备节点),因此那里只适用第 2 步。请将 NODE_OPTIONS 和 MALLOC_ARENA_MAX 放入 overleaf-env ConfigMap(个性化你的实例)。MongoDB 缓存已在部署 MongoDB 和 Redis 中设置。
最后修改于 2026年11月21日