選擇你的安裝方式
在 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 RAM 的伺服器上執行 Overleaf,其主要以 Node.js 為基礎的核心元件約會占用 1 GB 記憶體。Redis 與 MongoDB 可能還需要額外 0.5 GB,而啟動一個用於編譯的沙箱 Docker 容器又會再占用約 0.3 GB。這表示一台 2 核心、2 GB 的伺服器實際上一次只能處理約一個並行編譯。- 安裝 Ayakaleaf Pro 的最低硬體需求為 2 核心 CPU 與 3 GB RAM。
- 由於我們的 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 kernel 7.0,而 MongoDB 在 Linux kernel 6.19 至 7.0.13 上無法啟動(詳細資訊)。若要在這些 kernel 上執行,請在
overleaf-toolkit/config/docker-compose.override.yml(也就是設定 Ayakaleaf Pro 映像檔的同一個檔案)的 mongo 服務中加入以下內容。我們的 CI 就是在 Ubuntu 26.04 上搭配此設定執行。Kernel 7.0.14 及更新版本則不需要此設定。docker-compose.override.yml

