选择安装方式
在 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 社区版?设置
想要切换回官方 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

