跳转到主要内容
Ayakaleaf Pro 是官方 Overleaf 社区版的直接替代品,以 Docker 镜像的形式提供。

选择安装方式

在 Linux 上安装

在 Linux 上使用 Docker Compose(包括 Docker)

在 Windows 上安装

在 Windows 上使用 Docker Compose(通过 WSL)

在 Mac 上安装

在 macOS 上使用 Docker Compose(Docker Desktop)

在 Kubernetes 集群上运行

使用 Kubernetes(实验性)

在小型服务器上运行

仅适用于小型服务器(需要 2 GB 交换空间)

让 Claude 或 Codex 完成安装

使用 Claude 或 Codex

在浏览器中快速试用

使用 GitHub Codespace(精简版 TeX Live)

迁移现有的 Overleaf

从现有的 Overleaf 实例迁移

无网络环境下安装

适用于内部使用的离线/隔离网络部署
从官方 Overleaf Server Pro 迁移而来?(两者有何区别?)请在迁移前提交一个 issue:模板的存储方式不同,我们会免费为你提供帮助。
想要切换回官方 Overleaf 社区版?设置 SERVER_PRO=false(ayaka-notes Toolkit)或删除 override 文件(官方 Toolkit)即可。数据不会丢失。

硬件要求

我们进行了相关测试,发现如果在 2 核、2 GB 内存的服务器上运行 Overleaf,其主要基于 Node.js 的核心组件大约会占用 1 GB 内存。Redis 和 MongoDB 可能还需要额外 0.5 GB,而启动一个用于编译的沙盒 Docker 容器又会占用约 0.3 GB。这意味着一台 2 核、2 GB 的服务器实际上一次只能处理大约一个并发编译。
  • 安装 Ayakaleaf Pro 的最低硬件要求为 2 核 CPU 和 3 GB 内存。
  • 由于我们的 TeX Live 镜像体积较大,启用沙盒编译至少需要 40 GB 存储空间。
  • 如果你想安装 2020 年至 2026 年的完整 TeX Live 镜像集,请确保至少有 150 GB 的可用磁盘空间。
以下是针对不同使用场景推荐的硬件配置:

软件要求

在软件要求方面,我们建议使用较新且稳定的 Ubuntu 版本(例如 2025–2026 年使用 Ubuntu 24.04,2023–2024 年使用 Ubuntu 22.04),并搭配最新稳定版的 Docker。
Ubuntu 26.04 搭载 Linux 内核 7.0,而 MongoDB 在 Linux 内核 6.19 至 7.0.13 上无法启动(详情)。如需在这些内核上运行,请在 overleaf-toolkit/config/docker-compose.override.yml(即设置 Ayakaleaf Pro 镜像的同一文件)的 mongo 服务中添加以下内容。我们的 CI 就是在 Ubuntu 26.04 上使用此设置运行的。内核 7.0.14 及更高版本无需此设置。
docker-compose.override.yml
对于共享服务器和生产服务器,我们推荐使用 Linux。你也可以使用 Docker Desktop 在 macOS 或使用 WSL 2 的 Windows 上运行 Ayakaleaf Pro。请按照与你的平台对应的指南操作。镜像同时支持 AMD64 和 ARM64。

LaTeX 性能

LaTeX 是单线程程序,这意味着它一次只能使用一个 CPU 核心。编译单个文档时,性能主要受限于 CPU 的单核时钟频率。因此,CPU 的单核性能越强,编译文档的速度就越快。只有在多个用户同时编译文档时,更多的 CPU 核心才会带来好处。 以 ThuThesis 模板为例,在 Intel Core i9-14900K(5.6 GHz)上编译时间约为 6 秒,而在搭载 AMD EPYC 7763(3.2 GHz)的 Azure Standard D2as v5 实例(2 vCPU,8 GiB 内存)上则需要约 13 秒。 当然,实际编译性能取决于你的硬件配置。大多数服务器 CPU 的时钟频率达不到 14900K 那么高,因此你需要在成本和编译速度之间进行权衡。 同时,我们也对 LaTeX 编译性能进行了深入分析。如果你感兴趣,请参阅我们的博客文章 Overleaf Benchmark:Overleaf(SaaS 与自托管)并发 LaTeX 编译深度研究。
最后修改于 2026年11月21日