Chuyển đến nội dung chính
Ayakaleaf Pro là một bản thay thế trực tiếp (drop-in replacement) cho Overleaf Community Edition chính thức, được phân phối dưới dạng Docker image.

Chọn cách cài đặt của bạn

Cài đặt trên Linux

Dùng Docker Compose trên Linux (kèm Docker)

Cài đặt trên Windows

Dùng Docker Compose trên Windows (với WSL)

Cài đặt trên Mac

Dùng Docker Compose trên macOS (Docker Desktop)

Chạy trên cụm Kubernetes

Dùng Kubernetes (thử nghiệm)

Chạy trên máy chủ rất nhỏ

Chỉ dành cho máy chủ nhỏ (cần 2 GB swap)

Để Claude hoặc Codex cài đặt

Dùng Claude hoặc Codex

Dùng thử nhanh trong trình duyệt

Dùng GitHub Codespace (TeX Live tối giản)

Di chuyển một Overleaf hiện có

Di chuyển từ một phiên bản Overleaf hiện có

Cài đặt không cần Internet

Triển khai cách ly/ngoại tuyến cho mục đích nội bộ
Bạn đang chuyển từ Overleaf Server Pro chính thức? (Khác biệt là gì?) Hãy mở một issue trước khi di chuyển: các mẫu được lưu trữ theo cách khác, và chúng tôi sẽ hỗ trợ bạn miễn phí.
Muốn quay lại Overleaf Community Edition chính thức? Đặt SERVER_PRO=false (Toolkit của ayaka-notes) hoặc xóa tệp override (Toolkit chính thức). Không dữ liệu nào bị mất.

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:

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.
Ubuntu 26.04 đ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). Để chạy trên các nhân này, hãy thêm nội dung sau vào service mongo trong overleaf-toolkit/config/docker-compose.override.yml (cũng là tệp dùng để đặt image Ayakaleaf Pro). CI của chúng tôi chạy trên Ubuntu 26.04 với thiết lập này. Nhân 7.0.14 trở lên không cần thiết lập này.
docker-compose.override.yml
Chúng tôi khuyến nghị Linux cho các máy chủ dùng chung và máy chủ production. Bạn cũng có thể chạy Ayakaleaf Pro trên macOS hoặc Windows với WSL 2 bằng Docker Desktop. Hãy làm theo hướng dẫn dành cho nền tảng của bạn. Các image hỗ trợ cả AMD64 và ARM64.

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 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).
Lần sửa đổi cuối 21 tháng 11, 2026