メインコンテンツへスキップ
開発環境の Sandbox Compiles は、本番イメージとは少し異なる動作をします。開発環境ではすでに設定済みです。このページでは、その設定と注意すべき 3 つの点を説明します。
  • ファイル権限の問題
  • history-v1 と filestore 間のボリューム共有
  • サブディレクトリの問題

Sandbox Compiles を有効にする

Sandbox Compiles はデフォルトで有効です。develop/docker-compose.yml が clsi に SANDBOXED_COMPILES=true を設定し、残りは develop/dev.env にあります。
develop/dev.env
clsi は自分でイメージを pull しないため、docker pull ghcr.io/ayaka-notes/texlive-full:2026.1(および :2025.1)でイメージを一度 pull してください。 LaTeX は兄弟コンテナ内で TEXLIVE_IMAGE_USER として実行されます。開発環境ではこれは tex で、clsi のデフォルトでもあります(services/clsi/config/settings.defaults.cjs:154)。本番イメージでは、SANDBOXED_COMPILES_SIBLING_CONTAINERS=true のときに代わりに www-data を使います(server-ce/config/env.sh:15-21)。本番ではファイルが Overleaf コンテナの www-data ユーザーによって作成されるためです。
自分でビルドしたイメージは使用しないでください。一連のエラーが発生する可能性があります。

ファイル権限を修正する

clsi コンテナは root として起動し、compiles、output、cache フォルダーを node ユーザー(uid 1000)に渡してから、clsi を node として実行します(services/clsi/entrypoint.sh)。そのため、ホスト上の develop/compiles は uid 1000 の所有となり、開発環境の tex と同じ uid です(develop/pandoc/Dockerfile のコメントを参照)。上記の設定なら、開発環境は権限を変更しなくてもコンパイルできます。 代わりに TEXLIVE_IMAGE_USER=root を設定した場合、root(uid 0)には compiles のサブフォルダーへの書き込み権限がありません。その場合は、compiles の所有グループを root にして書き込み権限を与え、新しいサブフォルダーがこの所有権を継承するように setgid を設定します。
bash
詳細なドキュメントは services/clsi/README.md を参照してください。

history-v1 と filestore 間のボリューム共有

このセクションと次のセクションの設定は、すでに develop/docker-compose.yml と develop/dev.env に含まれています。これらが関係するのは develop/dev.rc で S3_ENABLED=false の場合だけです。デフォルトの S3_ENABLED=true では、filestore と history-v1 はこれらのファイルを代わりに RustFS のバケットに保存します(develop/s3/docker-compose.yml)。
デフォルトでは、filestore は S3 と Overleaf の他のサービスとの橋渡し役を担います。しかし Overleaf CE や Server Pro では、デフォルトですべてのファイルがローカルに保存されます。そのため、Overleaf は非常にトリッキーな方法を導入しています。
server-ce/config/settings.js
同時に、data/history は履歴サービスでも使われます。こうして異なるマイクロサービス間で同じデータを共有できます。そのため、develop の filestore サービスは history-v1 の history-v1-buckets ボリュームをマウントしています。これがないと、clsi は filestore サービスから blob ファイルを取得できません。
develop/docker-compose.yml
filestore は dev.env の次の設定でバケットを見つけます。
develop/dev.env

サブディレクトリを使用する

filestore は履歴の blob を常にサブディレクトリ付きで読み込みます(services/filestore/app/js/KeyBuilder.js:58、:70)。本番イメージは history-v1 の useSubdirectories を有効にしますが(server-ce/config/production.json)、history-v1 のデフォルト設定では有効にならないため、開発環境では history-v1 がすべてのデータをフラットにしてしまいます。そのため dev.env は history-v1 に NODE_CONFIG を設定しています。
develop/dev.env
これがないと、history-v1 は project_blobs のファイルを次のように保存します。
useSubdirectories を true にすると、これらの名前の _ が / になり、各 blob がサブフォルダーに保存されます。
最終更新日 2026年11月20日