Vai al contenuto principale
Questi servizi opzionali non sono necessari per eseguire Overleaf, ma aiutano molto a sviluppare, fare debug ed esaminare i dati. Fanno tutti parte dell’ambiente di sviluppo, quindi non c’è nulla da aggiungere a docker-compose.yml. Dopo l’accesso al sito, il menu Dev tools nella sua barra di navigazione rimanda a quelli che il sito serve sui propri percorsi.
Nessuno di questi strumenti ha un login: gli utenti anonimi di Grafana ne sono gli amministratori, e Mongo Express può modificare qualsiasi documento. Il sito, Hoppscotch, Mongo Express (8081) e RedisInsight (5540) sono in ascolto solo su 127.0.0.1 dell’host, quindi gli altri host non possono raggiungerli.

Grafana

Grafana è servito dal sito su /grafana/, tramite webpack-dev-server, quindi non gli serve una porta propria. La sua cartella Overleaf Develop contiene queste dashboard:

All services: lo stato di ogni servizio, l'host e le risorse usate da ogni servizio

Data flow: una modifica nel suo percorso da document-updater attraverso project-history fino a history-v1 e Mongo

Prometheus raccoglie /metrics dei servizi, mongodb-exporter, redis-exporter, cadvisor e node-exporter; Alloy invia i log di ogni container del progetto a Loki, dove li leggono i filtri Log search, Service e Log level delle dashboard. I loro dati vivono solo nei container, quindi ricrearli li svuota. cAdvisor gira in modalità privilegiata e legge /, /sys, i dati di Docker e il socket di containerd dell’host, in sola lettura; node-exporter legge / dell’host. Le dashboard sono generate: modifica develop/grafana/make-dashboards ed eseguilo, invece di modificare i file JSON.

Mailpit

Con MAILPIT_ENABLED=true, web invia ogni email a Mailpit invece che a un vero server di posta, e la conferma dell’email è attiva (EMAIL_CONFIRMATION_DISABLED=false). Link di attivazione, inviti ai progetti, reimpostazioni della password e codici di conferma si possono quindi seguire dalla casella di posta.

Un'email di attivazione, un invito a un progetto, un codice di conferma e una reimpostazione della password in Mailpit

Mailpit non ha un volume: ricreare il suo container svuota la casella di posta.

Mongo Express

Mongo Express mostra le collezioni del database sharelatex e permette di visualizzare, modificare, importare ed esportare i loro documenti.

Le collezioni del database sharelatex in Mongo Express

RedisInsight

RedisInsight conserva le sue connessioni in develop/data/redis-insight. La prima volta, scegli Connect existing database e inserisci l’host redis e la porta 6379.

RedisInsight connesso al servizio redis

Configurare Hoppscotch

Richieste API tramite proxy

Hoppscotch invia le richieste dal browser, che non può raggiungere i servizi tramite i loro nomi Docker. Il suo proxy, Proxyscotch, gira nella rete Docker ed è servito su /proxy dell’indirizzo di Hoppscotch. Apri http://localhost:9170, vai in Settings → Interceptor, scegli Proxy e imposta la Proxy URL su http://localhost:9170/proxy. L’impostazione resta nel browser.

L'impostazione Interceptor. Lo screenshot proviene da una configurazione precedente: usa http://localhost:9170/proxy come Proxy URL.

Ora puoi fare una prova con http://web:3000/status per verificare che il servizio web sia attivo:

Importare le API dei servizi

develop/hoppscotch/openapi/ contiene un file OpenAPI per l’API interna di ogni servizio. In Hoppscotch, apri Collections → Import → Import from File e seleziona tutti i file in una volta. Ogni file diventa una collezione le cui richieste vanno all’indirizzo Docker del servizio. Gli stessi file sono mostrati nella sezione API dei servizi.

Problemi con CSRF

Se usi Postman o altri strumenti di debug per generare una richiesta POST, potresti notare che il login viene rifiutato con un errore 403. Questo accade perché Overleaf è protetto dalla verifica CSRF.
Nella console potresti vedere:
Per gestire questo problema durante lo sviluppo di Overleaf, devi configurare il token CSRF. Ecco il tutorial dettagliato.
1

Aggiungere una Pre-Request

Aggiungi il seguente codice nella sezione Pre-Request
Lo script è il seguente:
2

Aggiungere gli header della richiesta

Devi aggiungere i seguenti header:
3

Effettuare il login con gli strumenti API

Ora puoi effettuare il login con il tuo nome utente e la tua password.
Ecco la risposta che ottieni se inserisci un nome utente o una password errati.
Ultima modifica il 20 novembre 2026