跳轉到主要內容
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 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
對於共用與正式環境的伺服器,我們建議使用 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 RAM)上則約需 13 秒。 當然,實際編譯效能取決於你的硬體設定。大多數伺服器 CPU 的時脈都沒有 14900K 那麼高,因此你需要在成本與編譯速度之間做取捨。 此外,我們也對 LaTeX 編譯效能進行了深入分析。若有興趣,請參閱我們的部落格文章 Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host)。
最後修改於 2026年11月21日