Přejít na hlavní obsah
Tyto volitelné služby nejsou k běhu Overleaf potřeba, ale velmi pomáhají při vývoji, ladění a zkoumání dat. Všechny jsou součástí vývojového prostředí, takže do docker-compose.yml není třeba nic přidávat. Jakmile se přihlásíte na web, menu Dev tools v jeho navigační liště odkazuje na nástroje, které web poskytuje na vlastních cestách.
Žádný z těchto nástrojů nemá přihlášení: anonymní uživatelé Grafany jsou jejími administrátory a Mongo Express může změnit jakýkoli dokument. Web, Hoppscotch, Mongo Express (8081) a RedisInsight (5540) naslouchají pouze na 127.0.0.1 hostitele, takže ostatní hostitelé se k nim nedostanou.

Grafana

Grafanu poskytuje web na /grafana/ přes webpack-dev-server, takže nepotřebuje vlastní port. Její složka Overleaf Develop obsahuje tyto dashboardy:

All services: stav každé služby, hostitel a prostředky, které každá služba používá

Data flow: úprava na cestě z document-updater přes project-history do history-v1 a Mongo

Prometheus sbírá /metrics služeb, mongodb-exporter, redis-exporter, cadvisor a node-exporter; Alloy posílá logy každého kontejneru projektu do Loki, kde je čtou filtry Log search, Service a Log level dashboardů. Jejich data jsou jen v kontejnerech, takže se při jejich opětovném vytvoření vymažou. cAdvisor běží privilegovaně a jen pro čtení čte /, /sys, data Dockeru a socket containerd hostitele; node-exporter čte / hostitele. Dashboardy se generují: místo úprav souborů JSON změňte develop/grafana/make-dashboards a spusťte ho.

Mailpit

S MAILPIT_ENABLED=true posílá web každý e-mail do Mailpitu místo skutečného poštovního serveru a potvrzování e-mailů je zapnuté (EMAIL_CONFIRMATION_DISABLED=false). Aktivační odkazy, pozvánky do projektů, obnovení hesla a potvrzovací kódy pak můžete otevírat ze schránky.

Aktivační e-mail, pozvánka do projektu, potvrzovací kód a obnovení hesla v Mailpitu

Mailpit nemá svazek: opětovné vytvoření jeho kontejneru schránku vyprázdní.

Mongo Express

Mongo Express zobrazuje kolekce databáze sharelatex a umí jejich dokumenty zobrazit, upravit, importovat a exportovat.

Kolekce databáze sharelatex v Mongo Express

RedisInsight

RedisInsight ukládá svá připojení do develop/data/redis-insight. Poprvé zvolte Connect existing database a zadejte hostitele redis a port 6379.

RedisInsight připojený ke službě redis

Nastavení Hoppscotch

Proxy pro požadavky API

Hoppscotch posílá požadavky z prohlížeče, který služby podle jejich jmen v Dockeru nedosáhne. Jeho proxy, Proxyscotch, běží uvnitř sítě Dockeru a je poskytována na /proxy adresy Hoppscotch. Otevřete http://localhost:9170, přejděte do Settings → Interceptor, zvolte Proxy a nastavte Proxy URL na http://localhost:9170/proxy. Nastavení zůstane v prohlížeči.

Nastavení Interceptor. Snímek obrazovky pochází ze starší instalace: jako Proxy URL použijte http://localhost:9170/proxy.

Nyní můžete pomocí http://web:3000/status otestovat, zda služba web běží:

Import API služeb

develop/hoppscotch/openapi/ obsahuje soubor OpenAPI pro interní API každé služby. V Hoppscotch otevřete Collections → Import → Import from File a vyberte všechny soubory najednou. Z každého souboru se stane kolekce, jejíž požadavky jdou na adresu služby v Dockeru. Stejné soubory jsou zobrazeny v sekci API služeb.

Problémy s CSRF

Pokud pomocí Postmanu nebo jiných ladicích nástrojů vytvoříte požadavek POST, můžete zjistit, že přihlášení je zakázáno a příčinou je chyba 403. Je to proto, že Overleaf je chráněn ověřováním CSRF.
V konzoli můžete vidět:
Abyste to při vývoji Overleafu vyřešili, musíte nastavit CSRF token. Zde je podrobný návod.
1

Přidání Pre-Request skriptu

Přidejte následující kód do Pre-Request
Skript je následující:
2

Přidání hlaviček požadavku

Musíte přidat následující hlavičky:
3

Přihlášení pomocí nástrojů API

Nyní se můžete přihlásit pomocí svého uživatelského jména a hesla.
Takto vypadá odpověď, když zadáte nesprávné uživatelské jméno nebo heslo.
Naposledy změněno 20. listopadu 2026