Chuyển đến nội dung chính
Điều quan trọng là bạn phải tạo một bản sao lưu nhất quán trước mỗi lần nâng cấp phiên bản chính, để có thể khôi phục lại khi cần.
Ayakaleaf toolkit↗ là một kho mã git, vì vậy rất dễ để nhận các tính năng mới của Toolkit. Chỉ cần chạy lệnh bin/upgrade và làm theo hướng dẫn trên màn hình. Lưu ý rằng phiên bản Docker image (tại config/version) được quản lý tách biệt với các bản cập nhật mã của Toolkit. Việc cập nhật mã Toolkit sẽ không tự động thay đổi phiên bản Docker image mà bạn đang chạy. Điều này có nghĩa là trong hầu hết các trường hợp, bạn có thể nâng cấp phiên bản Toolkit mà không cần nâng cấp triển khai của mình.

Script bin/upgrade

Khi bạn chạy lệnh bin/upgrade, script sẽ kiểm tra xem có bản cập nhật nào cho mã Toolkit hay không và đề nghị cập nhật Toolkit của bạn. Bạn luôn có thể từ chối bản nâng cấp này và sẽ không có gì thay đổi. Nếu bạn chọn cập nhật mã Toolkit, script sẽ kiểm tra xem phiên bản Docker image mặc định có thay đổi hay không và đề nghị nâng cấp tệp phiên bản cục bộ của bạn (tại config/version) cho khớp với phiên bản mặc định mới. Nếu bạn chọn chuyển phiên bản, script sẽ hướng dẫn bạn qua quy trình tắt các dịch vụ Docker, tạo bản sao lưu và khởi động lại các dịch vụ Docker. Tệp phiên bản cũ của bạn sẽ được tự động sao chép sang config/__old-version, phòng khi bạn cần quay lại phiên bản Docker image đó.
Đối với các thiết lập air-gapped nhập Docker image thủ công, vui lòng đặt PULL_BEFORE_UPGRADE=false trong tệp config/overleaf.rc.Vui lòng xem tại đây để biết thêm thông tin về việc triển khai trong môi trường air-gapped/ngoại tuyến.

Lộ trình nâng cấp

Nếu bạn đang chạy một phiên bản Overleaf Community cũ hơn v6.0.0, hãy tham khảo tài liệu chính thức của Overleaf để hoàn tất việc nâng cấp. Trong Ayakaleaf Pro, trước tiên hãy nâng cấp lên bản vá (patch) mới nhất của dòng phiên bản hiện tại, sau đó mới nâng cấp lên dòng tiếp theo, ví dụ 6.2.0 → 6.2.2 → 6.3.2. Hãy đọc ghi chú phát hành của mọi phiên bản bạn đi qua, một số phiên bản cần thêm các bước bổ sung. Chỉ bản phát hành mới nhất được hỗ trợ. Để kiểm tra bạn đang chạy image nào, hãy dùng docker inspect --format '{{.Config.Image}}' sharelatex.

Hỏi & Đáp

Trả lời: Script này cấp cho người dùng hiện có các tính năng mặc định của phiên bản của bạn, chẳng hạn như thời gian chờ biên dịch được đặt bởi COMPILE_TIMEOUT. Script chỉ tăng các giá trị và không bao giờ giảm chúng, vì vậy người dùng có thời gian chờ biên dịch dài hơn sẽ giữ nguyên giá trị đó. Script không phải là một phần của quá trình nâng cấp và không bao giờ tự chạy; bạn chỉ cần dùng nó sau khi tăng một giá trị mặc định như COMPILE_TIMEOUT. Theo mặc định, script chạy ở chế độ thử (dry run) và liệt kê những người dùng mà nó sẽ thay đổi; hãy thêm --dry-run=false để lưu các thay đổi:
Lần sửa đổi cuối 2 tháng 11, 2026