Перейти до основного вмісту
Ці необов’язкові сервіси не потрібні для роботи 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 р.