Hoppa till huvudinnehåll
Dessa valfria tjänster behövs inte för att köra Overleaf, men de hjälper mycket vid utveckling, felsökning och granskning av data. Alla ingår i utvecklingsmiljön, så det finns inget att lägga till i docker-compose.yml. När du är inloggad på webbplatsen länkar menyn Dev tools i navigeringsfältet till de verktyg som webbplatsen serverar på egna sökvägar.
Inget av dessa verktyg har inloggning: Grafanas anonyma användare är dess administratörer, och Mongo Express kan ändra vilket dokument som helst. Webbplatsen, Hoppscotch, Mongo Express (8081) och RedisInsight (5540) lyssnar bara på värdens 127.0.0.1, så andra värdar kan inte nå dem.

Grafana

Grafana serveras av webbplatsen på /grafana/ via webpack-dev-server och behöver därför ingen egen port. Mappen Overleaf Develop innehåller dessa instrumentpaneler:

All services: tillståndet för varje tjänst, värden och resurserna som varje tjänst använder

Data flow: en ändring på väg från document-updater via project-history till history-v1 och Mongo

Prometheus hämtar /metrics från tjänsterna, mongodb-exporter, redis-exporter, cadvisor och node-exporter; Alloy skickar loggarna från varje container i projektet till Loki, där instrumentpanelernas filter Log search, Service och Log level läser dem. Deras data finns bara i containrarna, så om de återskapas töms den. cAdvisor körs privilegierat och läser värdens /, /sys, Docker-data och containerd-socketen, skrivskyddat; node-exporter läser värdens /. Instrumentpanelerna genereras: ändra develop/grafana/make-dashboards och kör det i stället för att redigera JSON-filerna.

Mailpit

Med MAILPIT_ENABLED=true skickar web all e-post till Mailpit i stället för till en riktig e-postserver, och e-postbekräftelse är på (EMAIL_CONFIRMATION_DISABLED=false). Aktiveringslänkar, projektinbjudningar, lösenordsåterställningar och bekräftelsekoder kan då följas från inkorgen.

Ett aktiveringsmejl, en projektinbjudan, en bekräftelsekod och en lösenordsåterställning i Mailpit

Mailpit har ingen volym: om containern återskapas töms inkorgen.

Mongo Express

Mongo Express visar samlingarna i databasen sharelatex och kan visa, redigera, importera och exportera deras dokument.

Samlingarna i databasen sharelatex i Mongo Express

RedisInsight

RedisInsight sparar sina anslutningar i develop/data/redis-insight. Första gången väljer du Connect existing database och anger värden redis och porten 6379.

RedisInsight anslutet till tjänsten redis

Konfigurera Hoppscotch

Proxy för API-anrop

Hoppscotch skickar förfrågningar från webbläsaren, som inte kan nå tjänsterna via deras Docker-namn. Dess proxy, Proxyscotch, körs i Docker-nätverket och serveras på /proxy på Hoppscotch-adressen. Öppna http://localhost:9170, gå till Settings → Interceptor, välj Proxy och ange Proxy URL till http://localhost:9170/proxy. Inställningen sparas i webbläsaren.

Interceptor-inställningen. Skärmbilden kommer från en äldre konfiguration: använd http://localhost:9170/proxy som Proxy URL.

Nu kan du testa med http://web:3000/status för att kontrollera att web är igång:

Importera tjänsternas API:er

develop/hoppscotch/openapi/ innehåller en OpenAPI-fil för varje tjänsts interna API. Öppna Collections → Import → Import from File i Hoppscotch och välj alla filer på en gång. Varje fil blir en samling vars förfrågningar går till tjänstens Docker-adress. Samma filer visas i avsnittet Tjänste-API.

CSRF-problem

Om du använder Postman eller andra felsökningsverktyg för att skicka en POST-förfrågan kan du märka att inloggningen nekas, och orsaken är ett 403-fel. Det beror på att Overleaf skyddas av CSRF-verifiering.
I konsolen kan du se:
För att hantera detta i din Overleaf-utveckling behöver du konfigurera din CSRF-token. Här är en detaljerad guide.
1

Lägg till Pre-Request

Lägg till följande kod i Pre-Request
Skriptet ser ut så här:
2

Lägg till request-headers

Du behöver lägga till följande headers:
3

Logga in med API-verktyg

Nu kan du logga in med ditt användarnamn och lösenord.
Så här ser svaret ut när du anger fel användarnamn eller lösenord.
Senast ändrad 20 november 2026