Перейти к основному содержанию
Эти необязательные сервисы не нужны для работы Overleaf, но очень помогают при разработке, отладке и изучении данных. Все они входят в среду разработки, поэтому в docker-compose.yml ничего добавлять не нужно. После входа на сайт меню Dev tools в его панели навигации ссылается на инструменты, которые сайт отдаёт по собственным путям.
Ни у одного из этих инструментов нет входа: анонимные пользователи Grafana являются её администраторами, а Mongo Express может изменить любой документ. Сайт, Hoppscotch, Mongo Express (8081) и RedisInsight (5540) слушают только 127.0.0.1 хоста, поэтому другие хосты не могут к ним обратиться.

Grafana

Grafana отдаётся сайтом по пути /grafana/ через webpack-dev-server, поэтому ей не нужен собственный порт. В её папке Overleaf Develop есть такие дашборды:

All services: состояние каждого сервиса, хост и ресурсы, которые использует каждый сервис

Data flow: правка на пути от document-updater через project-history к history-v1 и Mongo

Prometheus собирает /metrics сервисов, mongodb-exporter, redis-exporter, cadvisor и node-exporter; Alloy отправляет логи каждого контейнера проекта в Loki, откуда их читают фильтры Log search, Service и Log level дашбордов. Их данные хранятся только в контейнерах, поэтому пересоздание контейнеров их очищает. cAdvisor работает в привилегированном режиме и только читает /, /sys, данные Docker и сокет containerd хоста; node-exporter читает / хоста. Дашборды генерируются: вместо редактирования JSON-файлов измените develop/grafana/make-dashboards и запустите его.

Mailpit

При MAILPIT_ENABLED=true web отправляет каждое письмо в Mailpit вместо настоящего почтового сервера, а подтверждение email включено (EMAIL_CONFIRMATION_DISABLED=false). Ссылки активации, приглашения в проекты, сбросы пароля и коды подтверждения можно открывать прямо из почтового ящика.

Письмо активации, приглашение в проект, код подтверждения и сброс пароля в Mailpit

У Mailpit нет тома: пересоздание его контейнера очищает почтовый ящик.

Mongo Express

Mongo Express показывает коллекции базы данных sharelatex и позволяет просматривать, редактировать, импортировать и экспортировать их документы.

Коллекции базы данных sharelatex в Mongo Express

RedisInsight

RedisInsight хранит свои подключения в develop/data/redis-insight. В первый раз выберите Connect existing database и укажите хост redis и порт 6379.

RedisInsight, подключённый к сервису redis

Настройка Hoppscotch

Проксирование API-запросов

Hoppscotch отправляет запросы из браузера, который не может обратиться к сервисам по их именам в Docker. Его прокси, Proxyscotch, работает внутри сети Docker и доступен по пути /proxy адреса Hoppscotch. Откройте http://localhost:9170, перейдите в Settings → Interceptor, выберите Proxy и задайте Proxy URL http://localhost:9170/proxy. Настройка сохраняется в браузере.

Настройка Interceptor. Снимок экрана сделан со старой конфигурации: используйте http://localhost:9170/proxy в качестве Proxy URL.

Теперь можно отправить запрос на http://web:3000/status, чтобы проверить, работает ли web:

Импорт API сервисов

В develop/hoppscotch/openapi/ есть файл OpenAPI для внутреннего API каждого сервиса. В Hoppscotch откройте Collections → Import → Import from File и выберите все файлы сразу. Каждый файл становится коллекцией, запросы которой идут на Docker-адрес сервиса. Те же файлы показаны в разделе API сервисов.

Проблемы с CSRF

Если вы используете Postman или другие инструменты отладки для отправки POST-запроса, вход может оказаться запрещён с ошибкой 403. Это происходит потому, что Overleaf защищён проверкой CSRF.
В консоли вы можете увидеть:
Чтобы решить эту проблему при разработке Overleaf, нужно настроить CSRF-токен. Ниже приведена подробная инструкция.
1

Добавьте Pre-Request

Добавьте следующий код в Pre-Request
Скрипт выглядит так:
2

Добавьте заголовки запроса

Необходимо добавить следующие заголовки:
3

Войдите с помощью инструментов API

Теперь можно войти, используя имя пользователя и пароль.
Так выглядит ответ, если введены неверные имя пользователя или пароль.
Последнее изменение 20 ноября 2026 г.