メインコンテンツへスキップ
これらのオプションのサービスは Overleaf の実行には必要ありませんが、開発、デバッグ、データの調査に大いに役立ちます。すべて開発環境の一部なので、docker-compose.yml に追加するものはありません。サイトにログインすると、ナビゲーションバーの Dev tools メニューから、サイトが独自のパスで提供しているツールにリンクされます。
これらのツールにはいずれもログインがありません。Grafana の匿名ユーザーは管理者であり、Mongo Express は任意のドキュメントを変更できます。サイト、Hoppscotch、Mongo Express(8081)、RedisInsight(5540)はホストの 127.0.0.1 のみで待ち受けるため、他のホストからはアクセスできません。

Grafana

Grafana は webpack-dev-server を通じてサイトの /grafana/ で提供されるため、専用のポートは不要です。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_CONFIRMATION_DISABLED=false)。有効化リンク、プロジェクトへの招待、パスワードリセット、確認コードを受信箱からたどれます。

Mailpit の有効化メール、プロジェクト招待、確認コード、パスワードリセット

Mailpit にはボリュームがありません。コンテナを再作成すると受信箱は空になります。

Mongo Express

Mongo Express は sharelatex データベースのコレクションを表示し、そのドキュメントの閲覧、編集、インポート、エクスポートができます。

Mongo Express の sharelatex データベースのコレクション

RedisInsight

RedisInsight は接続情報を develop/data/redis-insight に保存します。初回は Connect existing database を選び、ホストに redis、ポートに 6379 を入力してください。

redis サービスに接続した RedisInsight

Hoppscotch のセットアップ

API リクエストのプロキシ

Hoppscotch はブラウザからリクエストを送信しますが、ブラウザは Docker 名でサービスに到達できません。そのプロキシである Proxyscotch は Docker ネットワーク内で動作し、Hoppscotch のアドレスの /proxy で提供されます。http://localhost:9170 を開き、Settings → Interceptor で Proxy を選び、Proxy URL を http://localhost:9170/proxy に設定します。この設定はブラウザに保存されます。

Interceptor の設定。スクリーンショットは古い構成のものです。Proxy URL には http://localhost:9170/proxy を使用してください。

これで http://web:3000/status にリクエストを送り、web が稼働しているかを確認できます。

サービス API をインポートする

develop/hoppscotch/openapi/ には、各サービスの内部 API の OpenAPI ファイルがあります。Hoppscotch で Collections → Import → Import from File を開き、すべてのファイルを一度に選択します。各ファイルは、リクエストがサービスの Docker アドレスに送られるコレクションになります。同じファイルは サービス API セクションに表示されています。

CSRF の問題

Postman などのデバッグツールで POST リクエストを送信すると、ログインが forbidden になり、403 エラーが返されることがあります。これは Overleaf が CSRF 検証によって保護されているためです。
コンソールには次のように表示される場合があります。
Overleaf の開発でこれに対処するには、CSRF トークンを設定する必要があります。以下に詳しい手順を示します。
1

Pre-Request を追加する

Pre-Request に次のコードを追加します。
スクリプトは以下のとおりです。
2

リクエストヘッダーを追加する

以下のヘッダーを追加する必要があります。
3

API ツールでログインする

これでユーザー名とパスワードでログインできます。
以下は、誤ったユーザー名またはパスワードを入力した場合のレスポンスです。
最終更新日 2026年11月20日