Saltar para o conteúdo principal
Estes serviços opcionais não são necessários para executar o Overleaf, mas ajudam muito a desenvolver, depurar e examinar os dados. Todos fazem parte do ambiente de desenvolvimento, então não há nada a adicionar ao docker-compose.yml. Depois que você faz login no site, o menu Dev tools na barra de navegação aponta para os que o site serve em seus próprios caminhos.
Nenhuma dessas ferramentas tem login: os usuários anônimos do Grafana são seus administradores, e o Mongo Express pode alterar qualquer documento. O site, o Hoppscotch, o Mongo Express (8081) e o RedisInsight (5540) escutam apenas em 127.0.0.1 do host, então outros hosts não conseguem acessá-los.

Grafana

O Grafana é servido pelo site em /grafana/, por meio do webpack-dev-server, então não precisa de uma porta própria. Sua pasta Overleaf Develop tem estes dashboards:

All services: o estado de cada serviço, o host e os recursos que cada serviço usa

Data flow: uma edição a caminho do document-updater, passando pelo project-history, até o history-v1 e o Mongo

O Prometheus coleta /metrics dos serviços, mongodb-exporter, redis-exporter, cadvisor e node-exporter; o Alloy envia os logs de cada contêiner do projeto ao Loki, onde os filtros Log search, Service e Log level dos dashboards os leem. Os dados ficam apenas nos contêineres, então recriá-los os esvazia. O cAdvisor roda com privilégios e lê /, /sys, os dados do Docker e o socket do containerd do host, somente leitura; o node-exporter lê / do host. Os dashboards são gerados: altere develop/grafana/make-dashboards e execute-o, em vez de editar os arquivos JSON.

Mailpit

Com MAILPIT_ENABLED=true, o web envia todo e-mail ao Mailpit em vez de a um servidor de e-mail real, e a confirmação de e-mail fica ativada (EMAIL_CONFIRMATION_DISABLED=false). Links de ativação, convites de projeto, redefinições de senha e códigos de confirmação podem então ser seguidos pela caixa de entrada.

Um e-mail de ativação, um convite de projeto, um código de confirmação e uma redefinição de senha no Mailpit

O Mailpit não tem volume: recriar o contêiner esvazia a caixa de entrada.

Mongo Express

O Mongo Express mostra as coleções do banco sharelatex e permite ver, editar, importar e exportar seus documentos.

As coleções do banco sharelatex no Mongo Express

RedisInsight

O RedisInsight guarda suas conexões em develop/data/redis-insight. Na primeira vez, escolha Connect existing database e informe o host redis e a porta 6379.

RedisInsight conectado ao serviço redis

Configurar o Hoppscotch

Requisições de API via proxy

O Hoppscotch envia requisições a partir do navegador, que não consegue alcançar os serviços pelos nomes do Docker. Seu proxy, o Proxyscotch, roda dentro da rede do Docker e é servido em /proxy do endereço do Hoppscotch. Abra http://localhost:9170, vá em Settings → Interceptor, escolha Proxy e defina a Proxy URL como http://localhost:9170/proxy. A configuração fica no navegador.

A configuração do Interceptor. A captura de tela é de uma configuração antiga: use http://localhost:9170/proxy como Proxy URL.

Agora você pode testar com http://web:3000/status para verificar se o web está ativo:

Importar as APIs dos serviços

develop/hoppscotch/openapi/ tem um arquivo OpenAPI para a API interna de cada serviço. No Hoppscotch, abra Collections → Import → Import from File e selecione todos os arquivos de uma vez. Cada arquivo vira uma coleção cujas requisições vão para o endereço Docker do serviço. Os mesmos arquivos aparecem na seção API dos serviços.

Problemas de CSRF

Se você usar o Postman ou outras ferramentas de depuração para gerar uma requisição post, poderá perceber que o login é proibido, resultando em um erro 403. Isso acontece porque o Overleaf é protegido por verificação csrf.
No seu console, você poderá ver:
Para lidar com isso no desenvolvimento do Overleaf, você precisa configurar o seu token csrf. Aqui está o tutorial detalhado.
1

Adicionar Pre-Request

Adicione o seguinte código ao Pre-Request
O script é o seguinte:
2

Adicionar cabeçalhos da requisição

Você precisa adicionar os seguintes cabeçalhos:
3

Fazer login com ferramentas de API

Agora você pode fazer login com seu nome de usuário e senha.
Esta é a resposta quando você informa um nome de usuário ou senha incorretos.
Última modificação em 20 de novembro de 2026