> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Giới thiệu

> Triển khai Ayakaleaf Pro với hướng dẫn về di chuyển, yêu cầu hệ thống và hiệu năng LaTeX.

Giống như Overleaf Server Pro, Ayakaleaf Pro của chúng tôi được cung cấp dưới dạng Docker container và có thể thay thế trực tiếp, đồng thời bổ sung các tính năng như SSO qua LDAP và SAML2, bảo mật được cải thiện, theo dõi thay đổi, bình luận, phiên bản TeX Live được tối ưu hóa của chúng tôi, mẫu và bảng quản trị.

* Nếu bạn chỉ muốn kiểm thử các tính năng của Ayakaleaf Pro hoặc dùng thử bản demo, bạn có thể làm theo hướng dẫn [using-the-github-codespace.md](/vi/on-premises/installation/using-the-github-codespace "mention"). Môi trường demo sử dụng bản cài đặt TeX Live tối thiểu, vì vậy một số dự án của bạn có thể không biên dịch thành công.
* Nếu bạn chưa từng triển khai bất kỳ phiên bản Overleaf nào trước đây, vui lòng tham khảo [Thiết lập Docker](/vi/on-premises/installation/setup-docker) để cài đặt Docker Engine trước, sau đó cài đặt Overleaf [bằng toolkit](/vi/on-premises/installation/using-the-toolkit "mention").
* Nếu bạn đã triển khai Community Edition của Overleaf, vui lòng tham khảo [migrate-from-existing.md](/vi/on-premises/installation/migrate-from-existing "mention") để chuyển sang Ayakaleaf Pro.
* Nếu bạn thích sử dụng các agent như Claude hoặc Codex, bạn có thể tham khảo: [using-claude-or-codex.md](/vi/on-premises/installation/using-claude-or-codex "mention").
* Nếu bạn cần triển khai trong môi trường ngoại tuyến hoặc air-gapped, vui lòng tham khảo: [air-gapped-offline-deployments.md](/vi/on-premises/installation/air-gapped-offline-deployments "mention").
* Nếu bạn là người dùng Server Pro hiện tại, vui lòng mở một issue để cho chúng tôi biết trước khi chuyển sang Ayakaleaf Pro, vì dữ liệu mẫu được lưu theo định dạng hơi khác. Chúng tôi rất sẵn lòng hỗ trợ bạn chuyển từ Server Pro sang Ayakaleaf Pro hoàn toàn miễn phí.
* Nếu một lúc nào đó bạn cảm thấy chán Ayakaleaf Pro và muốn quay lại Overleaf Community Edition chính thức, điều đó được hỗ trợ đầy đủ. Không dữ liệu nào của bạn bị mất. Đối với người dùng Overleaf Toolkit chính thức, chỉ cần xóa tệp YAML override của bạn. Đối với người dùng toolkit của ayaka-notes, hãy tắt tùy chọn `SERVER_PRO`. Mọi thứ sau đó sẽ quay về Community Edition tiêu chuẩn.

Vui lòng chọn phương thức cài đặt phù hợp với nhu cầu của bạn:

<Card title="Sử dụng GitHub Codespace" icon="file-lines" href="/vi/on-premises/installation/using-the-github-codespace" horizontal />

<Card title="Sử dụng Toolkit" icon="file-lines" href="/vi/on-premises/installation/using-the-toolkit" horizontal />

<Card title="Sử dụng Claude hoặc Codex" icon="file-lines" href="/vi/on-premises/installation/using-claude-or-codex" horizontal />

<Card title="Triển khai air-gapped/ngoại tuyến" icon="file-lines" href="/vi/on-premises/installation/air-gapped-offline-deployments" horizontal />

<Card title="Di chuyển từ bản cài đặt hiện có" icon="file-lines" href="/vi/on-premises/installation/migrate-from-existing" horizontal />

### Yêu cầu phần cứng

Chúng tôi đã tiến hành các thử nghiệm liên quan và nhận thấy rằng, nếu bạn chạy Overleaf trên máy chủ 2 nhân, 2 GB RAM, các thành phần cốt lõi của nó — chủ yếu dựa trên Node.js — sẽ tiêu tốn khoảng 1 GB bộ nhớ. Redis và MongoDB có thể cần thêm 0,5 GB, trong khi việc khởi động một Docker container sandbox để biên dịch có thể tiêu tốn thêm 0,3 GB. Điều này có nghĩa là một máy chủ 2 nhân, 2 GB trên thực tế chỉ có thể xử lý khoảng một lần biên dịch đồng thời.

* Yêu cầu phần cứng tối thiểu để cài đặt Ayakaleaf Pro là CPU 2 nhân và 3 GB RAM.
* Do kích thước của TeX Live image, cần ít nhất 40 GB dung lượng lưu trữ để bật biên dịch trong sandbox.
* Nếu bạn muốn cài đặt toàn bộ các TeX Live image từ 2020 đến 2026, hãy đảm bảo bạn có ít nhất 150 GB dung lượng đĩa trống.

Dưới đây là một số cấu hình phần cứng được khuyến nghị cho các tình huống sử dụng khác nhau:

| Tình huống sử dụng | Cấu hình khuyến nghị |
| - | - |
| Sử dụng cá nhân, thỉnh thoảng cộng tác | 2 nhân CPU, 4 GB RAM, 80 GB lưu trữ |
| Nhóm nhỏ, tối đa 10 người dùng với mức cộng tác nhẹ | 2 nhân CPU, 8 GB RAM, 256 GB lưu trữ |
| Nhóm cỡ vừa, tối đa 100 người dùng | 4 nhân CPU, 16 GB RAM, 1 TB lưu trữ |
| Triển khai quy mô lớn hoặc cho trường đại học | Triển khai cụm phân tán, với lưu trữ S3; vui lòng liên hệ chúng tôi nếu bạn cần hỗ trợ triển khai |

### Yêu cầu phần mềm

Về yêu cầu phần mềm, chúng tôi khuyến nghị sử dụng phiên bản Ubuntu gần đây và ổn định (ví dụ: Ubuntu 24.04 trong giai đoạn 2025–2026, Ubuntu 22.04 trong giai đoạn 2023–2024) cùng với phiên bản Docker ổn định mới nhất.

<Info>
  Ổn định là ưu tiên hàng đầu: hãy chọn bản Ubuntu LTS mới nhất đã phát hành được một thời gian, chứ không phải bản vừa mới ra mắt. Ví dụ, tính đến tháng 10 năm 2026, Ubuntu 26.04 không được hỗ trợ: nó đi kèm nhân Linux 7.0, và MongoDB từ chối khởi động trên nhân Linux từ 6.19 đến 7.0.13 ([chi tiết](https://www.mongodb.com/docs/manual/administration/production-notes/)), vì vậy vui lòng sử dụng Ubuntu 24.04.
</Info>

Chúng tôi không khuyến nghị triển khai Ayakaleaf Pro trên Windows hoặc các hệ điều hành không được hỗ trợ khác như CentOS, vì bạn có thể gặp các vấn đề tương thích hoặc sự cố không mong muốn trong quá trình cài đặt và vận hành.

Nhưng nếu bạn muốn thử triển khai Ayakaleaf Pro trên các hệ thống dựa trên ARM hoặc macOS, chúng tôi hoan nghênh bạn chia sẻ kinh nghiệm và phản hồi với cộng đồng.

### Hiệu năng LaTeX

LaTeX là một chương trình đơn luồng, nghĩa là nó chỉ có thể sử dụng một nhân CPU tại một thời điểm. Khi biên dịch một tài liệu đơn lẻ, hiệu năng chủ yếu bị giới hạn bởi xung nhịp đơn nhân của CPU. Do đó, hiệu năng đơn nhân của CPU càng cao thì bạn biên dịch tài liệu càng nhanh. Nhiều nhân CPU hơn chỉ có lợi khi nhiều người dùng biên dịch tài liệu đồng thời.

Lấy [mẫu ThuThesis](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) làm ví dụ, thời gian biên dịch khoảng 6 giây trên Intel Core i9-14900K (5,6 GHz), trong khi mất khoảng 13 giây trên một phiên bản Azure Standard D2as v5 (2 vCPU, 8 GiB RAM) chạy AMD EPYC 7763 (3,2 GHz).

Tất nhiên, hiệu năng biên dịch thực tế phụ thuộc vào cấu hình phần cứng của bạn. Hầu hết CPU máy chủ không chạy ở xung nhịp cao như 14900K, vì vậy bạn sẽ cần cân nhắc giữa chi phí và tốc độ biên dịch.

Đồng thời, chúng tôi cũng đã thực hiện một phân tích chuyên sâu về hiệu năng biên dịch LaTeX. Nếu bạn quan tâm, vui lòng tham khảo bài blog của chúng tôi [Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host)](/vi/blog/2026/overleaf-benchmark "mention").


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.