推薦的開發工具
這些選用服務不是執行 Overleaf 所必需的,但在開發、除錯和檢視資料時非常有幫助。它們都是開發環境的一部分,因此不需要在docker-compose.yml 中新增任何內容。登入網站後,導覽列中的 Dev tools 選單會連結到網站在自身路徑上提供的工具。
Grafana
Grafana 由網站透過 webpack-dev-server 在/grafana/ 上提供,因此不需要獨立的連接埠。它的 Overleaf Develop 資料夾中有以下儀表板:

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

Data flow:一次編輯從 document-updater 經 project-history 到 history-v1 和 Mongo 的過程
/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 中的啟用郵件、專案邀請、確認碼和密碼重設
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。

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


1
新增 Pre-Request
將以下程式碼加入 Pre-Request
腳本如下:

2
新增請求標頭
您需要新增以下標頭:

3
使用 API 工具登入
現在您可以使用您的使用者名稱與密碼登入。以下是輸入錯誤的使用者名稱或密碼時的回應。


