Chuyển đến nội dung chính
Nếu bạn đang sử dụng phiên bản cũ hơn, vui lòng dùng sharelatex thay cho overleaf trong tên đường dẫn.
Về mặt kỹ thuật, có thể gắn (mount) hệ thống tệp NFS vào container Overleaf, nhưng điều này không được khuyến nghị và có thể gây ra nhiều loại lỗi hiệu năng khác nhau.Một lỗi thường gặp khi biên dịch là:
Đặc biệt, chúng tôi khuyên không nên dùng hệ thống tệp dựa trên NFS cho dữ liệu tạm thời, chẳng hạn như các thư mục dùng cho dữ liệu biên dịch. Chúng tôi khuyến nghị sử dụng một ổ đĩa tạm cục bộ, tốt nhất là SSD cục bộ, cho các thư mục sau.Đối với các thiết lập dựa trên docker-compose, chúng tôi đề xuất chỉ cần ghi đè bind-mount từ NFS, cách này giúp tránh việc thay đổi đường dẫn trong ứng dụng. Dưới đây là ví dụ một đoạn cấu hình docker-compose sử dụng ổ đĩa tạm được gắn tại /scratch:
docker-compose excerpt
Không cần di chuyển bất kỳ tệp hiện có nào từ NFS sang vị trí mới sau khi cập nhật. Trình biên dịch LaTeX có thể tạo lại tất cả các tệp bằng một lần biên dịch đầy đủ.Để biết thêm chi tiết, xem: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Nếu bạn chạy Overleaf trên Windows hoặc macOS, dịch vụ mongo có thể không khởi động lại được, kèm theo lỗi:
Example error
Lỗi này có thể xảy ra khi dữ liệu MongoDB được bind-mount từ một hệ thống tệp không cung cấp các đặc tính mà nó yêu cầu, chẳng hạn như một thư mục được gắn từ Windows. Đối với Windows với WSL 2, hãy đặt Toolkit trong thư mục home Linux của Ubuntu và sử dụng các bind mount mặc định. Xem các bước kiểm tra MongoDB trong hướng dẫn cho nền tảng này.Đối với một bản cài đặt mới cần bộ lưu trữ do Docker quản lý, override sau đây sử dụng các named volume (xem hướng dẫn lưu trữ của image MongoDB). Trên một bản cài đặt hiện có, việc thay đổi mount không di chuyển dữ liệu: hãy sao lưu và khôi phục cơ sở dữ liệu/bộ nhớ đệm trước khi chuyển đổi, nếu không dịch vụ sẽ thấy các volume trống. Thêm nội dung này vào config/docker-compose.override.yml, hợp nhất với mọi cấu hình hiện có:
config/docker-compose.override.yml
Để biết thêm thông tin, xem: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Sử dụng lệnh docker logs redis để xuất một bản sao log.Nếu bạn thấy dòng Fatal: Can't initialize Background Jobs, toàn bộ đầu ra sẽ trông giống như sau:
Redis log example
Điều này có thể liên quan đến phiên bản Docker đang sử dụng. Cập nhật lên phiên bản >= 20.10.10 sẽ giải quyết được vấn đề này.Để biết thêm thông tin, xem issue upstream của Redis: https://github.com/redis/redis/issues/12362Tham khảo: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Đôi khi, ảnh xem trước/thu nhỏ do Ayakaleaf Pro tạo ra có thể bị sai hướng và cần can thiệp thủ công để sửa. Các ảnh này được lưu trong /var/lib/overleaf/data/template_files/.Chúng tôi khuyến nghị sao lưu thư mục này trước khi thực hiện bất kỳ thay đổi nào.Bạn cần thực hiện các bước dưới đây cho từng mẫu bị ảnh hưởng:Tìm ID của mẫuĐiều hướng đến thư viện mẫu của phiên bản của bạn (/templates/all), mở một mẫu bị ảnh hưởng và sao chép ID từ URL (ví dụ: https://your-instance-url/templates/6645d346c224815e9460a695).Chạy lệnh sửa lỗiChạy lệnh sau từ máy chủ Docker host (thay ID mẫu bằng ID bạn đã sao chép và cập nhật đường dẫn nếu cần):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Tham khảo: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
Lệnh \write18 bị tắt theo mặc định trong Community Edition vì tất cả các lần biên dịch đều diễn ra trong cùng một container sharelatex; đây là mặc định an toàn hơn.Nếu bạn muốn bật lệnh này cho pdflatex, hãy tạo tệp latexmkrc trong thư mục gốc của dự án với nội dung sau:
latexmkrc
Sau đó thử biên dịch lại.Tham khảo: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Các lỗi này có nghĩa là container mongo liên tục bị crash và khởi động lại. bin/up khởi động MongoDB rồi chạy một lệnh bên trong nó, và lệnh này thất bại trong khi container đang khởi động lại. bin/docker-compose ps hiển thị dịch vụ mongo ở trạng thái Restarting.Để tìm nguyên nhân thực sự, hãy đọc log của MongoDB:
Các nguyên nhân phổ biến là:
  • CPU không hỗ trợ AVX. MongoDB 5.0 trở lên cần AVX trên x86-64, và log hiển thị MongoDB 5.0+ requires a CPU with AVX support. Trong máy ảo, hãy đặt loại CPU thành host để AVX được truyền qua.
  • Nhân Linux từ 6.19 đến 7.0.13. MongoDB từ chối khởi động trên các nhân này. Xem Yêu cầu phần mềm để biết cách khắc phục.
  • Dữ liệu được tạo bởi phiên bản MongoDB cũ hơn. MongoDB 8.0 không thể mở trực tiếp dữ liệu từ 4.4 hoặc 5.0. Hãy nâng cấp từng phiên bản chính một, xem Cập nhật MongoDB.
Đây là hành vi bình thường với Ayakaleaf Pro và bạn có thể bỏ qua. Thông báo này được in ra khi OVERLEAF_IS_SERVER_PRO không phải là true, và đó là trường hợp trong image Ayakaleaf Pro. Ayakaleaf Pro không cần biến này, vì vậy hãy để trống nó.
Trước khi Overleaf khởi động, container sẽ chạy các kiểm tra khởi động và thoát khi một trong số đó thất bại. Toolkit chạy container với restart: always, vì vậy Docker khởi động lại nó và cùng một kiểm tra lại thất bại. Đầu ra khởi động cho biết tên của kiểm tra bị thất bại:
Các nguyên nhân phổ biến là:
  • Missing required secrets: đặt OVERLEAF_INVITE_TOKEN_SECRET trong config/variables.env, xem Biến môi trường.
  • ShareLaTeX to Overleaf rebranding: cấu hình vẫn dùng các biến hoặc đường dẫn SHARELATEX_; hãy đổi tên chúng theo hướng dẫn trong thông báo.
  • Một lỗi xuất hiện sau Checking can connect to mongo and redis: Overleaf không thể kết nối tới MongoDB hoặc Redis. Hãy kiểm tra bin/logs mongo và bin/logs redis.
Sau khi khắc phục nguyên nhân, hãy chạy bin/up -d.
Mỗi lần khởi động, container chạy lần lượt các script khởi động của nó, và log ghi tên từng script dưới dạng *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery chỉ có việc cần làm trên những phiên bản từng chạy Overleaf 5.0.1. Trên mọi phiên bản khác, nó in ra No recovery of doc versions needed. và quá trình khởi động tiếp tục. Đầu ra của nó cũng được ghi vào data/history/doc-version-recovery.log trong OVERLEAF_DATA_PATH.Mã thoát và phần cuối của bin/docker-compose logs --tail=100 sharelatex cho biết điều gì đã xảy ra:
  • Mã thoát 2, và log kết thúc bằng *** Init system aborted.: container đã bị dừng, ví dụ bởi bin/stop, docker stop hoặc Ctrl+C trên bin/up. Script trong dòng Running cuối cùng chỉ là script đang chạy vào thời điểm đó, nó không bị lỗi. Hãy khởi động lại container bằng bin/up -d và để quá trình khởi động hoàn tất.
  • Mã thoát 1, và log hiển thị *** /etc/my_init.d/<script> failed with status <n>: script đó đã bị lỗi, và thông báo lỗi của nó nằm ở các dòng ngay phía trên. Nếu 910_initiate_doc_version_recovery bị lỗi với Detected unflushed changes while recovering doc versions, phiên bản đó đã chạy 5.0.1 và vẫn còn các chỉnh sửa chưa được flush; hãy làm theo hướng dẫn chính thức Doc version recovery.
Trang này được hiển thị khi tài khoản của bạn đã đăng nhập nhưng không được phép mở trang, ví dụ một trang quản trị được mở bởi tài khoản không phải quản trị viên, hoặc một dự án không được chia sẻ với bạn.Để mở các trang quản trị, hãy đăng nhập bằng tài khoản quản trị viên. Một quản trị viên hiện có có thể cấp quyền quản trị cho tài khoản khác, hoặc bạn có thể tạo một tài khoản bằng lệnh create-user --admin, xem Quản lý người dùng. Trong môi trường phát triển (develop/), các trang quản trị còn cần ADMIN_PRIVILEGE_AVAILABLE=true trong develop/dev.env; image Ayakaleaf Pro đã đặt sẵn biến này.
Lần sửa đổi cuối 8 tháng 11, 2026