Skip to main content
Đ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.
Lần sửa đổi cuối 4 tháng 10, 2026