Chuyển đến nội dung chính
Ayakaleaf Pro chạy được trên máy chủ có 2 lõi CPU và 2 GB bộ nhớ, kể cả tích hợp Git, khi bạn thêm 2 GB swap. Không có swap, nó hết bộ nhớ trong lúc khởi động. Các thiết lập ở bước 2 còn giảm mức dùng swap gần một nửa.
Chúng tôi đo trên Ayakaleaf Pro 6.3.1 với Toolkit, trong một máy ảo QEMU/KVM 2 vCPU / 2 GiB chạy Ubuntu 24.04, với biên dịch trong sandbox (texlive-basic:2025.1) và tích hợp Git được bật.

Vì sao 2 GB không đủ với thiết lập mặc định

Khi nhàn rỗi với thiết lập mặc định, Ayakaleaf Pro cần khoảng 1,9 GiB. Ubuntu và Docker đã dùng 364 MiB của máy 2 GiB, chỉ còn lại khoảng 1600 MiB.

  1. Thêm 2 GB swap

Đây là bước quan trọng nhất.

  1. Giảm mức dùng bộ nhớ

Thêm các dòng sau vào config/variables.env. Container tích hợp Git cũng đọc tệp này.
variables.env
Để giới hạn bộ đệm MongoDB, thêm mục mongo dưới services trong config/docker-compose.override.yml (chính tệp đặt image Ayakaleaf Pro):
docker-compose.override.yml
Sau đó chạy bin/up -d.
NODE_OPTIONS thay thế giá trị được đặt trong image, nên dòng này phải giữ --require /overleaf/.pnp.cjs --import /overleaf/.pnp.register.mjs. Thiếu chúng, các dịch vụ Node.js không tải được gói của mình và không khởi động. Không thể dùng --optimize-for-size: Node.js từ chối tùy chọn này trong NODE_OPTIONS.--replSet overleaf là giá trị Toolkit truyền cho MongoDB theo mặc định. Hãy giữ nguyên.
Với heap 160 MiB, việc clone hoặc push một dự án lớn qua Git có thể hết bộ nhớ, và container tích hợp Git sẽ khởi động lại. Chúng tôi chưa kiểm thử trường hợp này. Nếu điều đó xảy ra, hãy tăng -Xmx.

Kết quả

Mỗi lần kiểm thử biên dịch một tài liệu LuaLaTeX 33 trang có fontspec và 30 hình TikZ; các lần biên dịch đồng thời là các dự án khác nhau. Không có swap, một lần bị dừng do hết bộ nhớ sẽ kéo theo lần tiếp theo: web khởi động lại, việc khởi động lại cần bộ nhớ, và máy chủ treo cho đến khi bị reset cứng. Có swap, ba lần biên dịch cùng lúc mất thời gian gần bằng một lần, vì những gì bị đẩy vào swap là các trang Node.js nhàn rỗi. Chưa kiểm thử: tải clone và push Git, nhiều người dùng chỉnh sửa cùng lúc, và swap trên ổ đĩa chậm (máy chủ của chúng tôi dùng SSD).

Kubernetes

Hướng dẫn Kubernetes của chúng tôi tắt swap trên các node (Chuẩn bị các node), nên ở đó chỉ áp dụng bước 2. Đặt NODE_OPTIONS và MALLOC_ARENA_MAX vào ConfigMap overleaf-env (Cá nhân hóa phiên bản của bạn). Bộ đệm MongoDB đã được đặt trong Triển khai MongoDB và Redis.
Lần sửa đổi cuối 21 tháng 11, 2026