> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/zh-tw/an-zhuang/introduction.md).

# 簡介

如同 Overleaf Server Pro，我們的 Ayakaleaf Pro 也是以 Docker 容器形式提供，可直接替換，並額外包含如透過 LDAP 與 SAML2 提供的 SSO、強化的安全性、修訂追蹤、註解、我們最佳化版本的 TeX Live、範本以及管理面板等功能。

* 如果您之前從未部署過任何版本的 Overleaf，請參考 [設定 Docker](/on-premises/zh-tw/an-zhuang/setup-docker.md) 先安裝 Docker Engine，然後安裝 Overleaf [使用 Toolkit](/on-premises/zh-tw/an-zhuang/using-the-toolkit.md).
* 如果您已經部署過 Overleaf Community Edition，請參考 [從現有版本遷移](/on-premises/zh-tw/an-zhuang/cong-xian-you-ban-ben-qian-yi.md) 以遷移到 Ayakaleaf-Pro。
* 如果您是現有的 Server Pro 使用者，請在遷移到 AyakaLeaf Pro 之前先開一個 issue 告知我們，因為範本資料的儲存格式略有不同。
* 有時候，如果您厭倦了我們的 AyakaLeaf Pro，想切換回官方的 Overleaf Community Edition，這是完全支援的。您的任何資料都不會遺失。對於官方 Overleaf Toolkit 的使用者，只需移除您的 override YAML 檔案。對於 ayaka-notes toolkit 的使用者，停用 `SERVER_PRO` 選項。之後一切都會回復為標準的 Community Edition。

### 硬體需求

* 安裝 AyakaLeaf Pro 的最低硬體需求為 2 核心 CPU 與 3 GB RAM。
* 由於我們的 TeX Live 映像檔較大，啟用沙盒化編譯至少需要 40 GB 的儲存空間。
* 如果您想安裝 2020 年至 2026 年的完整 TeX Live 映像檔，請確保至少有 150 GB 的可用磁碟空間。

以下是針對不同使用情境的一些建議硬體配置：

| 使用情境                 | 建議配置                    |
| -------------------- | ----------------------- |
| 個人使用，偶爾協作            | 2 個 CPU 核心，4 GB RAM     |
| 小型團隊，最多 10 位使用者，輕度協作 | 2 個 CPU 核心，8 GB RAM     |
| 中型團隊，最多 100 位使用者     | 4 個 CPU 核心，16 GB RAM    |
| 大型或校園部署              | 分散式叢集部署；如果您需要部署協助，請聯絡我們 |

### 軟體需求

在軟體需求方面，我們建議使用較新的 Ubuntu 版本，並搭配最新穩定版的 Docker。

我們不建議在 Windows 或其他不支援的作業系統上部署 AyakaLeaf Pro，因為您可能會在安裝與運作期間遇到相容性問題或非預期問題。

### LaTeX 效能

LaTeX 是單執行緒程式，也就是說它一次只能使用一個 CPU 核心。編譯單一文件時，CPU 也是主要限制。因此，您的 CPU 單核心效能越快，編譯文件的速度就越快。只有在您要編譯的文件數量超過可用 CPU 核心數時，更多核心才會有幫助。

以 [ThuThesis 範本](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) 為例，在 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 那麼高，因此您需要在成本與編譯速度之間取得權衡。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/zh-tw/an-zhuang/introduction.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
