- 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. 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 để cài đặt Docker Engine trước, sau đó cài đặt Overleaf bằng toolkit.
- Nếu bạn đã triển khai Community Edition của Overleaf, vui lòng tham khảo migrate-from-existing.md để 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.
- 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.
- 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.
Sử dụng GitHub Codespace
Sử dụng Toolkit
Sử dụng Claude hoặc Codex
Triển khai air-gapped/ngoại tuyến
Di chuyển từ bản cài đặt hiện có
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.
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.Ổ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), vì vậy vui lòng sử dụng Ubuntu 24.04.