跳轉到主要內容
如果您使用的是較早的版本,請在路徑名稱中使用 sharelatex 而非 overleaf。
技術上可以在 Overleaf 容器中掛載 NFS 檔案系統,但不建議這麼做,因為可能導致各種效能錯誤。編譯時常見的錯誤之一是:
特別是,我們不建議將以 NFS 為後端的檔案系統用於暫時性資料,例如用於編譯資料的目錄。對於以下目錄,我們建議使用本機暫存磁碟,最好是本機 SSD。對於以 docker-compose 為基礎的架構,我們建議直接覆寫來自 NFS 的綁定掛載,這樣就不需要變更應用程式中的路徑。以下是一個 docker-compose 設定摘錄的範例,使用掛載於 /scratch 的暫存磁碟:
docker-compose excerpt
更新後,不需要將任何現有檔案從 NFS 遷移到新位置。LaTeX 編譯器在重新執行完整編譯時可以重新建立所有檔案。更多詳細資訊請參閱:https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
如果您在 Windows 或 macOS 上執行 Overleaf,mongo 服務可能無法重新啟動,並出現以下錯誤:
Example error
當 MongoDB 資料是從無法提供其所需語意的檔案系統(例如 Windows 掛載的目錄)綁定掛載時,就可能發生此錯誤。對於搭配 WSL 2 的 Windows,請將 Toolkit 放在 Ubuntu 的 Linux 家目錄下,並使用預設的綁定掛載。請參閱該平台指南中的 MongoDB 檢查。對於需要由 Docker 管理儲存空間的新安裝,以下覆寫設定會使用具名磁碟區(請參閱 MongoDB 映像檔的儲存指引)。在既有的安裝上,變更掛載並不會遷移資料:切換之前請先備份並還原資料庫/快取,否則服務會看到空的磁碟區。請將以下內容加入 config/docker-compose.override.yml,並與任何既有設定合併:
config/docker-compose.override.yml
更多資訊請參閱:https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
使用 docker logs redis 指令輸出日誌副本。如果您看到 Fatal: Can't initialize Background Jobs 這一行,完整輸出大致如下:
Redis log example
這可能與目前使用的 Docker 版本有關。更新至 >= 20.10.10 的版本應可解決此問題。更多資訊請參閱 Redis 上游 issue:https://github.com/redis/redis/issues/12362參考資料:https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
由於所有編譯都在同一個 sharelatex 容器中進行,Community Edition 預設停用 \write18 指令;這是較安全的預設值。如果您希望為 pdflatex 啟用它,請在專案根目錄中建立一個 latexmkrc 檔案,內容如下:
latexmkrc
然後嘗試重新編譯。參考資料:https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
這些錯誤表示 mongo 容器不斷當機並重新啟動。bin/up 會先啟動 MongoDB,然後在其中執行指令,而該指令會在容器重新啟動時失敗。bin/docker-compose ps 會顯示 mongo 服務的狀態為 Restarting。若要找出實際原因,請查看 MongoDB 日誌:
常見原因包括:
  • CPU 不支援 AVX。MongoDB 5.0 及更新版本在 x86-64 上需要 AVX,日誌會顯示 MongoDB 5.0+ requires a CPU with AVX support。在虛擬機器中,請將 CPU 類型設為 host,讓 AVX 能夠傳遞給虛擬機器。
  • Linux 核心 6.19 至 7.0.13。MongoDB 拒絕在這些核心上啟動。因應方式請參閱軟體需求。
  • 資料是由較舊的 MongoDB 版本建立的。MongoDB 8.0 無法直接開啟 4.4 或 5.0 的資料。請一次升級一個主要版本,請參閱更新 MongoDB。
這在 Ayakaleaf Pro 中是預期的行為,您可以忽略此訊息。當 OVERLEAF_IS_SERVER_PRO 不是 true 時就會輸出此訊息,而 Ayakaleaf Pro 映像檔正是如此。Ayakaleaf Pro 不需要此變數,因此請保持未設定。
在 Overleaf 啟動之前,容器會執行啟動檢查,只要其中一項失敗就會結束。Toolkit 以 restart: always 執行該容器,因此 Docker 會再次啟動它,而同一項檢查又會再次失敗。啟動輸出中會指出失敗的檢查項目:
常見原因包括:
  • Missing required secrets:請在 config/variables.env 中設定 OVERLEAF_INVITE_TOKEN_SECRET,請參閱環境變數。
  • ShareLaTeX to Overleaf rebranding:設定中仍使用 SHARELATEX_ 變數或路徑;請依訊息指示重新命名。
  • Checking can connect to mongo and redis 之後出現錯誤:Overleaf 無法連線至 MongoDB 或 Redis。請檢查 bin/logs mongo 與 bin/logs redis。
修正原因後,請執行 bin/up -d。
每次啟動時,容器都會依序執行其啟動指令碼,而記錄檔會以 *** Running /etc/my_init.d/<script>... 標示每一個指令碼。910_initiate_doc_version_recovery 只在曾經執行過 Overleaf 5.0.1 的執行個體上才有工作要做。在其他任何執行個體上,它會印出 No recovery of doc versions needed.,然後繼續啟動。它的輸出也會寫入 OVERLEAF_DATA_PATH 中的 data/history/doc-version-recovery.log。結束代碼以及 bin/docker-compose logs --tail=100 sharelatex 的結尾可以說明發生了什麼事:
  • 結束代碼 2,且記錄檔以 *** Init system aborted. 結尾:容器被停止了,例如透過 bin/stop、docker stop 或在 bin/up 上按下 Ctrl+C。最後一行 Running 中的指令碼只是當時正在執行的那一個,它並沒有失敗。請使用 bin/up -d 再次啟動容器,並讓啟動完成。
  • 結束代碼 1,且記錄檔顯示 *** /etc/my_init.d/<script> failed with status <n>:該指令碼失敗了,其錯誤就在上方幾行。若 910_initiate_doc_version_recovery 以 Detected unflushed changes while recovering doc versions 失敗,表示該執行個體曾執行 5.0.1 且仍有未清空(unflushed)的編輯;請依照官方的 Doc version recovery 指南操作。
當您的帳號已登入、但沒有權限開啟該頁面時,就會顯示此頁面,例如以非管理員帳號開啟管理頁面,或開啟未與您共用的專案。若要開啟管理頁面,請以管理員帳號登入。現有的管理員可以將其他帳號設為管理員,您也可以使用 create-user --admin 指令建立管理員帳號,請參閱使用者管理。在開發環境(develop/)中,管理頁面還需要在 develop/dev.env 中設定 ADMIN_PRIVILEGE_AVAILABLE=true;Ayakaleaf Pro 映像檔已預先設定此項。
最後修改於 2026年11月8日