Passer au contenu principal
Ces services optionnels ne sont pas nécessaires pour faire fonctionner Overleaf, mais ils aident beaucoup pour développer, déboguer et examiner les données. Tous font partie de l’environnement de développement : il n’y a rien à ajouter à docker-compose.yml. Une fois connecté au site, le menu Dev tools de sa barre de navigation renvoie vers ceux que le site sert sur ses propres chemins.
Aucun de ces outils n’a de connexion : les utilisateurs anonymes de Grafana en sont les administrateurs, et Mongo Express peut modifier n’importe quel document. Le site, Hoppscotch, Mongo Express (8081) et RedisInsight (5540) n’écoutent que sur 127.0.0.1 de l’hôte, donc les autres hôtes ne peuvent pas les atteindre.

Grafana

Grafana est servi par le site sur /grafana/, via webpack-dev-server, il n’a donc pas besoin de port propre. Son dossier Overleaf Develop contient ces tableaux de bord :

All services : l'état de chaque service, l'hôte et les ressources utilisées par chaque service

Data flow : une modification en route de document-updater vers history-v1 et Mongo en passant par project-history

Prometheus collecte /metrics des services, mongodb-exporter, redis-exporter, cadvisor et node-exporter ; Alloy envoie les logs de chaque conteneur du projet à Loki, où les filtres Log search, Service et Log level des tableaux de bord les lisent. Leurs données ne vivent que dans les conteneurs, donc les recréer les vide. cAdvisor s’exécute en mode privilégié et lit /, /sys, les données Docker et le socket containerd de l’hôte, en lecture seule ; node-exporter lit / de l’hôte. Les tableaux de bord sont générés : modifiez develop/grafana/make-dashboards et exécutez-le, au lieu de modifier les fichiers JSON.

Mailpit

Avec MAILPIT_ENABLED=true, web envoie chaque e-mail à Mailpit au lieu d’un vrai serveur de messagerie, et la confirmation d’e-mail est activée (EMAIL_CONFIRMATION_DISABLED=false). Les liens d’activation, invitations de projet, réinitialisations de mot de passe et codes de confirmation peuvent alors être suivis depuis la boîte de réception.

Un e-mail d'activation, une invitation de projet, un code de confirmation et une réinitialisation de mot de passe dans Mailpit

Mailpit n’a pas de volume : recréer son conteneur vide la boîte de réception.

Mongo Express

Mongo Express affiche les collections de la base sharelatex et permet d’afficher, modifier, importer et exporter leurs documents.

Les collections de la base sharelatex dans Mongo Express

RedisInsight

RedisInsight conserve ses connexions dans develop/data/redis-insight. La première fois, choisissez Connect existing database et saisissez l’hôte redis et le port 6379.

RedisInsight connecté au service redis

Configurer Hoppscotch

Requêtes API via le proxy

Hoppscotch envoie les requêtes depuis le navigateur, qui ne peut pas joindre les services par leurs noms Docker. Son proxy, Proxyscotch, s’exécute dans le réseau Docker et est servi sur /proxy de l’adresse de Hoppscotch. Ouvrez http://localhost:9170, allez dans Settings → Interceptor, choisissez Proxy et définissez la Proxy URL sur http://localhost:9170/proxy. Le réglage reste dans le navigateur.

Le réglage Interceptor. La capture d'écran provient d'une ancienne configuration : utilisez http://localhost:9170/proxy comme Proxy URL.

Vous pouvez maintenant tester avec http://web:3000/status pour vérifier que le service web est actif :

Importer les API des services

develop/hoppscotch/openapi/ contient un fichier OpenAPI pour l’API interne de chaque service. Dans Hoppscotch, ouvrez Collections → Import → Import from File et sélectionnez tous les fichiers en une fois. Chaque fichier devient une collection dont les requêtes vont à l’adresse Docker du service. Les mêmes fichiers sont présentés dans la section API des services.

Problèmes de CSRF

Si vous utilisez Postman ou d’autres outils de débogage pour générer une requête POST, vous constaterez peut-être que la connexion est refusée, avec une erreur 403. Cela s’explique par le fait qu’Overleaf est protégé par une vérification CSRF.
Dans votre console, vous verrez peut-être :
Pour gérer cela dans votre développement Overleaf, vous devez configurer votre jeton CSRF. Voici le tutoriel détaillé.
1

Ajouter un script de pré-requête

Ajoutez le code suivant dans Pre-Request
Voici le script :
2

Ajouter les en-têtes de requête

Vous devez ajouter les en-têtes suivants :
3

Se connecter avec les outils d'API

Vous pouvez maintenant vous connecter avec votre nom d’utilisateur et votre mot de passe.
Voici la réponse obtenue lorsque vous saisissez un nom d’utilisateur ou un mot de passe incorrect.
Dernière modification le 20 novembre 2026