如果您使用的是較早的版本,請在路徑名稱中使用
sharelatex 而非 overleaf。在 NFS 檔案系統上執行 Overleaf
在 NFS 檔案系統上執行 Overleaf
技術上可以在 Overleaf 容器中掛載 NFS 檔案系統,但不建議這麼做,因為可能導致各種效能錯誤。編譯時常見的錯誤之一是:特別是,我們不建議將以 NFS 為後端的檔案系統用於暫時性資料,例如用於編譯資料的目錄。對於以下目錄,我們建議使用本機暫存磁碟,最好是本機 SSD。對於以 更新後,不需要將任何現有檔案從 NFS 遷移到新位置。LaTeX 編譯器在重新執行完整編譯時可以重新建立所有檔案。更多詳細資訊請參閱:https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
docker-compose 為基礎的架構,我們建議直接覆寫來自 NFS 的綁定掛載,這樣就不需要變更應用程式中的路徑。以下是一個 docker-compose 設定摘錄的範例,使用掛載於 /scratch 的暫存磁碟:docker-compose excerpt
在 Windows 或 macOS 上執行 Overleaf 導致 mongo 服務無法啟動
在 Windows 或 macOS 上執行 Overleaf 導致 mongo 服務無法啟動
如果您在 Windows 或 macOS 上執行 Overleaf,當 MongoDB 資料是從無法提供其所需語意的檔案系統(例如 Windows 掛載的目錄)綁定掛載時,就可能發生此錯誤。對於搭配 WSL 2 的 Windows,請將 Toolkit 放在 Ubuntu 的 Linux 家目錄下,並使用預設的綁定掛載。請參閱該平台指南中的 MongoDB 檢查。對於需要由 Docker 管理儲存空間的新安裝,以下覆寫設定會使用具名磁碟區(請參閱 MongoDB 映像檔的儲存指引)。在既有的安裝上,變更掛載並不會遷移資料:切換之前請先備份並還原資料庫/快取,否則服務會看到空的磁碟區。請將以下內容加入 更多資訊請參閱:https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
mongo 服務可能無法重新啟動,並出現以下錯誤:Example error
config/docker-compose.override.yml,並與任何既有設定合併:config/docker-compose.override.yml
升級至 Redis 6.2 導致不斷重新啟動
升級至 Redis 6.2 導致不斷重新啟動
使用 這可能與目前使用的 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
docker logs redis 指令輸出日誌副本。如果您看到 Fatal: Can't initialize Background Jobs 這一行,完整輸出大致如下:Redis log example
請確認您已啟用系統呼叫。對於 pdflatex,這是 'pdflatex -shell-escape'。
請確認您已啟用系統呼叫。對於 pdflatex,這是 'pdflatex -shell-escape'。
由於所有編譯都在同一個 然後嘗試重新編譯。參考資料:https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
sharelatex 容器中進行,Community Edition 預設停用 \write18 指令;這是較安全的預設值。如果您希望為 pdflatex 啟用它,請在專案根目錄中建立一個 latexmkrc 檔案,內容如下:latexmkrc
在「Initiating Mongo replica set...」之後,bin/up 失敗並顯示 unable to upgrade to tcp, received 409 或 OCI runtime exec failed
在「Initiating Mongo replica set...」之後,bin/up 失敗並顯示 unable to upgrade to tcp, received 409 或 OCI runtime exec failed
這些錯誤表示 常見原因包括:
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。
日誌顯示「Running Overleaf Community Edition, skipping TexLive checks」
日誌顯示「Running Overleaf Community Edition, skipping TexLive checks」
這在 Ayakaleaf Pro 中是預期的行為,您可以忽略此訊息。當
OVERLEAF_IS_SERVER_PRO 不是 true 時就會輸出此訊息,而 Ayakaleaf Pro 映像檔正是如此。Ayakaleaf Pro 不需要此變數,因此請保持未設定。容器停在 910_initiate_doc_version_recovery,或以結束代碼 2 結束
容器停在 910_initiate_doc_version_recovery,或以結束代碼 2 結束
每次啟動時,容器都會依序執行其啟動指令碼,而記錄檔會以
*** 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 指南操作。
「Restricted, sorry you don’t have permission to load this page」
「Restricted, sorry you don’t have permission to load this page」
當您的帳號已登入、但沒有權限開啟該頁面時,就會顯示此頁面,例如以非管理員帳號開啟管理頁面,或開啟未與您共用的專案。若要開啟管理頁面,請以管理員帳號登入。現有的管理員可以將其他帳號設為管理員,您也可以使用
create-user --admin 指令建立管理員帳號,請參閱使用者管理。在開發環境(develop/)中,管理頁面還需要在 develop/dev.env 中設定 ADMIN_PRIVILEGE_AVAILABLE=true;Ayakaleaf Pro 映像檔已預先設定此項。
