跳轉到主要內容
這些選用服務不是執行 Overleaf 所必需的,但在開發、除錯和檢視資料時非常有幫助。它們都是開發環境的一部分,因此不需要在 docker-compose.yml 中新增任何內容。登入網站後,導覽列中的 Dev tools 選單會連結到網站在自身路徑上提供的工具。
這些工具都沒有登入機制:Grafana 的匿名使用者就是其管理員,Mongo Express 可以修改任何文件。網站、Hoppscotch、Mongo Express(8081)和 RedisInsight(5540)只監聽主機的 127.0.0.1,因此其他主機無法存取它們。

Grafana

Grafana 由網站透過 webpack-dev-server 在 /grafana/ 上提供,因此不需要獨立的連接埠。它的 Overleaf Develop 資料夾中有以下儀表板:

All services:每個服務的狀態、主機以及每個服務使用的資源

Data flow:一次編輯從 document-updater 經 project-history 到 history-v1 和 Mongo 的過程

Prometheus 擷取各服務的 /metrics,以及 mongodb-exporter、redis-exporter、cadvisor 和 node-exporter;Alloy 將專案中每個容器的日誌傳送到 Loki,儀表板中的 Log search、Service 和 Log level 篩選器會從那裡讀取。這些資料只存在於容器中,因此重新建立容器會將其清空。cAdvisor 以特權模式執行,以唯讀方式讀取主機的 /、/sys、Docker 資料和 containerd 通訊端;node-exporter 讀取主機的 /。 儀表板是產生出來的:請修改 develop/grafana/make-dashboards 並執行它,而不要直接編輯 JSON 檔案。

Mailpit

設定 MAILPIT_ENABLED=true 後,web 會把每封郵件寄到 Mailpit 而不是真正的郵件伺服器,並且電子郵件確認會開啟(EMAIL_CONFIRMATION_DISABLED=false)。這樣就可以從收件匣開啟啟用連結、專案邀請、密碼重設和確認碼。

Mailpit 中的啟用郵件、專案邀請、確認碼和密碼重設

Mailpit 沒有磁碟區:重新建立其容器會清空收件匣。

Mongo Express

Mongo Express 顯示 sharelatex 資料庫中的集合,並可以檢視、編輯、匯入和匯出其中的文件。

Mongo Express 中 sharelatex 資料庫的集合

RedisInsight

RedisInsight 將其連線儲存在 develop/data/redis-insight 中。第一次使用時,選擇 Connect existing database,並輸入主機 redis 和連接埠 6379。

已連線到 redis 服務的 RedisInsight

設定 Hoppscotch

透過 Proxy 傳送 API 請求

Hoppscotch 從瀏覽器傳送請求,而瀏覽器無法透過 Docker 名稱存取各服務。它的代理 Proxyscotch 在 Docker 網路內執行,並在 Hoppscotch 位址的 /proxy 上提供。開啟 http://localhost:9170,前往 Settings → Interceptor,選擇 Proxy,並將 Proxy URL 設為 http://localhost:9170/proxy。此設定會保存在瀏覽器中。

Interceptor 設定。截圖來自較舊的設定:請使用 http://localhost:9170/proxy 作為 Proxy URL。

現在您可以用 http://web:3000/status 測試 web 服務是否正常運作:

匯入服務 API

develop/hoppscotch/openapi/ 中為每個服務的內部 API 提供了一個 OpenAPI 檔案。在 Hoppscotch 中開啟 Collections → Import → Import from File,並一次選取所有檔案。每個檔案都會成為一個集合,其請求會傳送到該服務的 Docker 位址。相同的檔案也顯示在 服務 API 一節中。

CSRF 問題

如果您使用 Postman 或其他除錯工具產生 POST 請求,可能會發現登入被禁止,原因是 403 錯誤。這是因為 Overleaf 受到 CSRF 驗證保護。
在主控台中,您可能會看到:
要在 Overleaf 開發中處理這個問題,您需要設定 CSRF token。以下是詳細教學。
1

新增 Pre-Request

將以下程式碼加入 Pre-Request
腳本如下:
2

新增請求標頭

您需要新增以下標頭:
3

使用 API 工具登入

現在您可以使用您的使用者名稱與密碼登入。
以下是輸入錯誤的使用者名稱或密碼時的回應。
最後修改於 2026年11月20日