Hopp til hovedinnhold
Disse valgfrie tjenestene trengs ikke for å kjøre Overleaf, men de hjelper mye ved utvikling, feilsøking og undersøkelse av dataene. Alle er en del av utviklingsmiljøet, så det er ingenting å legge til i docker-compose.yml. Når du er logget inn på nettstedet, lenker menyen Dev tools i navigasjonslinjen til de verktøyene nettstedet serverer på egne stier.
Ingen av disse verktøyene har innlogging: Grafanas anonyme brukere er administratorene, og Mongo Express kan endre ethvert dokument. Nettstedet, Hoppscotch, Mongo Express (8081) og RedisInsight (5540) lytter bare på vertens 127.0.0.1, så andre verter kan ikke nå dem.

Grafana

Grafana serveres av nettstedet på /grafana/ via webpack-dev-server, og trenger derfor ingen egen port. Mappen Overleaf Develop har disse dashbordene:

All services: tilstanden til hver tjeneste, verten og ressursene hver tjeneste bruker

Data flow: en endring på vei fra document-updater via project-history til history-v1 og Mongo

Prometheus henter /metrics fra tjenestene, mongodb-exporter, redis-exporter, cadvisor og node-exporter; Alloy sender loggene fra hver container i prosjektet til Loki, der dashbordenes filtre Log search, Service og Log level leser dem. Dataene ligger bare i containerne, så de tømmes når containerne gjenopprettes. cAdvisor kjører privilegert og leser vertens /, /sys, Docker-data og containerd-socketen, skrivebeskyttet; node-exporter leser vertens /. Dashbordene genereres: endre develop/grafana/make-dashboards og kjør det, i stedet for å redigere JSON-filene.

Mailpit

Med MAILPIT_ENABLED=true sender web all e-post til Mailpit i stedet for til en ekte e-postserver, og e-postbekreftelse er på (EMAIL_CONFIRMATION_DISABLED=false). Aktiveringslenker, prosjektinvitasjoner, tilbakestilling av passord og bekreftelseskoder kan da følges fra innboksen.

En aktiverings-e-post, en prosjektinvitasjon, en bekreftelseskode og en tilbakestilling av passord i Mailpit

Mailpit har ikke noe volum: hvis containeren gjenopprettes, tømmes innboksen.

Mongo Express

Mongo Express viser samlingene i databasen sharelatex og kan vise, redigere, importere og eksportere dokumentene deres.

Samlingene i databasen sharelatex i Mongo Express

RedisInsight

RedisInsight lagrer tilkoblingene sine i develop/data/redis-insight. Første gang velger du Connect existing database og angir verten redis og porten 6379.

RedisInsight koblet til tjenesten redis

Sette opp Hoppscotch

API-forespørsler via proxy

Hoppscotch sender forespørsler fra nettleseren, som ikke kan nå tjenestene via Docker-navnene deres. Proxyen, Proxyscotch, kjører i Docker-nettverket og serveres på /proxy på Hoppscotch-adressen. Åpne http://localhost:9170, gå til Settings → Interceptor, velg Proxy og sett Proxy URL til http://localhost:9170/proxy. Innstillingen lagres i nettleseren.

Interceptor-innstillingen. Skjermbildet er fra et eldre oppsett: bruk http://localhost:9170/proxy som Proxy URL.

Nå kan du teste med http://web:3000/status for å sjekke om web kjører:

Importer tjeneste-API-ene

develop/hoppscotch/openapi/ har en OpenAPI-fil for det interne API-et til hver tjeneste. Åpne Collections → Import → Import from File i Hoppscotch og velg alle filene samtidig. Hver fil blir en samling der forespørslene går til tjenestens Docker-adresse. De samme filene vises i delen Tjeneste-API.

CSRF-problemer

Hvis du bruker Postman eller andre feilsøkingsverktøy til å sende en POST-forespørsel, kan du oppleve at innloggingen blir avvist, og årsaken er 403-feilen. Det skyldes at Overleaf er beskyttet av CSRF-verifisering.
I konsollen kan du se:
For å håndtere dette i Overleaf-utviklingen må du sette opp CSRF-tokenet ditt. Her er en detaljert veiledning.
1

Legg til Pre-Request

Legg til følgende kode i Pre-Request
Skriptet er som følger:
2

Legg til forespørselsheadere

Du må legge til følgende headere:
3

Logg inn med API-verktøy

Nå kan du logge inn med brukernavn og passord.
Her er svaret når du skriver inn feil brukernavn eller passord.
Sist endret 20. november 2026