メインコンテンツへスキップ
Ayakaleaf Pro には、エンタープライズレベルのセキュリティのために、コンパイルを安全なサンドボックス環境で実行するオプションが用意されています。これは、各プロジェクトをそれぞれ専用の安全な Docker 環境で実行することで実現されます。

セキュリティの向上

多くの LaTeX ドキュメントは PDF コンパイル処理の一部として任意のシェルコマンドを実行する必要がある(または実行できる)ため、Ayakaleaf Pro では Sandboxed Compiles の使用が推奨されます。Sandboxed Compiles を使用すると、各コンパイルは機能が制限された個別の Docker コンテナで実行されます。このコンテナは他のユーザーやプロジェクトと共有されず、ホストネットワークなどの外部リソースにもアクセスできません。
Sandboxed Compiles なしで Ayakaleaf Pro を実行しようとすると、コンパイルはメインの Docker コンテナ内で他の同時実行中のコンパイルと並行して実行され、ユーザーは LaTeX のコンパイル実行時に sharelatex コンテナのリソース(ファイルシステム、ネットワーク、環境変数)に対して完全な読み書きアクセス権を持つことになります。

パッケージ管理の簡素化

パッケージを手動でインストールする手間を避けるため、Sandboxed Compiles を有効にすることをお勧めします。これは Ayakaleaf Pro 内の設定項目で、オンプレミス環境内でありながら、overleaf.com と同じ TeX Live 環境をユーザーに提供します。Sandboxed Compiles で使用される TeX Live イメージには、ギャラリーのテンプレートでテスト済みの人気のパッケージとフォントが含まれており、オンプレミスのプロジェクトとの最大限の互換性を確保します。 Sandboxed Compiles を有効にすると、ユーザーがプロジェクト内で選択できる TeX Live のバージョンを設定できるほか、新規プロジェクト用のデフォルトの TeX Live イメージのバージョンも設定できます。
Sandboxed Compiles なしで Ayakaleaf Pro を実行しようとすると、インスタンスはデフォルトで TeX Live の basic scheme 版を使用してコンパイルします。この basic 版は軽量で、ごく限られた LaTeX パッケージしか含まれていないため、特にユーザーが既製のテンプレートを使おうとした場合に、パッケージ不足のエラーが発生する可能性が高くなります。
Ayakaleaf Pro はオフラインで動作するように設計されているため、overleaf.com のギャラリーテンプレートをオンプレミス環境に統合する自動化された方法はありません。ただし、テンプレートごとに手動で行うことは可能です。この仕組みの詳細については、overleaf.com からのテンプレート移行ガイドを参照してください: #transferring-templates-from-overleaf.com。
Sandboxed Compiles では、sharelatex コンテナがこれらの兄弟コンパイルコンテナを管理できるように、(バインドマウントを介して)ホストマシン上の Docker ソケットにアクセスできる必要があります。

仕組み

Sandboxed Compiles を有効にすると、ホストマシンの Docker ソケットが sharelatex コンテナにマウントされ、コンテナ内のコンパイラーサービスがホスト上に新しい Docker コンテナを作成できるようになります。その後、各プロジェクトでコンパイラーが実行されるたびに、LaTeX コンパイラーサービス(CLSI)は次の処理を行います。
  • プロジェクトファイルを OVERLEAF_DATA_PATH 内の場所に書き出す。
  • マウントされた Docker ソケットを使用して、コンパイル実行用の新しい texlive コンテナを作成する。
  • texlive コンテナに OVERLEAF_DATA_PATH 配下の場所からプロジェクトデータを読み込ませる。
  • texlive コンテナ内でプロジェクトをコンパイルする。

Sandboxed Compiles の有効化

Toolkit ユーザーの場合

Sandboxed Compiles(兄弟コンテナとも呼ばれます)を有効にするには、overleaf-toolkit/config/overleaf.rc で次の設定オプションを指定します。
config/overleaf.rc
無効にするには、SIBLING_CONTAINERS_ENABLED=false を設定して bin/up を実行します。コンパイルは sharelatex コンテナー内で、その基本的な TeX Live を使って実行されるようになります。

Docker Compose ユーザーの場合

TeX Live イメージのセットアップ

中国本土のユーザーは、ダウンロードを高速化するために ghcr.nju.edu.cn ミラーからイメージを pull し、ghcr.io の名前でタグ付けできます。
Toolkit の環境設定では ghcr.nju.edu.cn を使用しないでください。そこでは ghcr.io の名前を維持してください。bin/up が ghcr.io から再度イメージを pull しないようにするには、config/overleaf.rc で SIBLING_CONTAINERS_PULL=false を設定します。ミラー経由でイメージを最新の状態に保つには、TeX Live Full イメージの自動更新を参照してください。
Ayakaleaf Pro は、Sandboxed Compiles で使用する TeX Live イメージを決定するために 3 つの環境変数を使用します。
  • TEX_LIVE_DOCKER_IMAGE (任意): 新規プロジェクトで使用される TeX Live イメージ。ALL_TEX_LIVE_DOCKER_IMAGES 内のいずれかのイメージである必要があります。未設定の場合、新規プロジェクトは ALL_TEX_LIVE_DOCKER_IMAGES の最初のイメージを使用します。
  • ALL_TEX_LIVE_DOCKER_IMAGE_NAMES (任意): コンパイラー設定に表示される、イメージと同じ順序で並べた名前のカンマ区切りリスト。未設定の場合、またはイメージのリストより短い場合、イメージはタグ(例: 2026.1)で表示されます。
  • ALL_TEX_LIVE_DOCKER_IMAGES (必須): 使用する TeX Live イメージのカンマ区切りリスト。デプロイに Overleaf Toolkit を使用している場合、これらのイメージがダウンロードまたは更新されます。ダウンロードをスキップするには、config/overleaf.rc で SIBLING_CONTAINERS_PULL=false を設定します。
bin/up コマンドで Ayakaleaf Pro インスタンスを起動すると、Toolkit は ALL_TEX_LIVE_DOCKER_IMAGES に記載されているすべてのイメージを自動的に pull します。 以下は、新規プロジェクトのデフォルトを TeX Live 2026 にし、既存のプロジェクト用に 2025 も引き続き使用する例です。
次の設定では、2025 年から 2026 年までのすべてのフル TeX Live Docker イメージをインストールします。この設定を使用する前に、少なくとも 64 GB の空きストレージを用意することをお勧めします。
config/variables.env
少なくとも 2 つの texlive-full イメージを設定することを強く推奨します。詳しい理由は #known-issues を参照してください。

利用可能な TeX Live イメージ

以下は Overleaf 向けに特別に最適化された一連の TeX Live イメージで、TEX_LIVE_DOCKER_IMAGE および ALL_TEX_LIVE_DOCKER_IMAGES に追加できます。
  • ghcr.io/ayaka-notes/texlive-full:2026.1(latest タグも同じ)
  • ghcr.io/ayaka-notes/texlive-full:2025.1
  • ghcr.io/ayaka-notes/texlive-full:2024.1
  • ghcr.io/ayaka-notes/texlive-full:2023.1
  • ghcr.io/ayaka-notes/texlive-full:2022.1
  • ghcr.io/ayaka-notes/texlive-full:2021.1
  • ghcr.io/ayaka-notes/texlive-full:2020.1
イメージのタグ付けには厳格なスキーマがあり、それに従う必要があります(正規表現 ^[0-9]+.[0-9]+ が適用され、最初の数字が TeX Live の年、2 番目の数字がパッチバージョンを表します)。

他のイメージレジストリを使用できますか

ghcr.io を別のミラーサイトに置き換えたり、texlive を Docker Hub の別のイメージに切り替えたりできるのか、と疑問に思う方もいるかもしれません。
設定が比較的複雑になるため、お勧めしません。ミラーサイトからダウンロードしている場合は、イメージの名前を ghcr.io/ayaka-notes/texlive-full に変更できます。 それでも独自のイメージレジストリを使用したい場合は、次を追加してください。
config/variables.env
次に、すべての texlive イメージが your-repo に存在することを確認する必要があります。例えば:
  • hub.your.com/your-repo/texlive-full:2025.1
  • hub.your.com/your-repo/texlive-full:2024.1
詳細については、以下のソースコードを読んで、環境変数がどのように解析されるかを確認してください。
sandboxed-compiles/index.mjs

TeX Live イメージの自動同期

毎回 bin/up で手動更新する手間を省くために、TeX Live イメージの更新を自動化できます。updating-tex-live-full-images-automatically.md を参照してください。

既知の問題

以下は Overleaf コミュニティで実際にあった事例です。
6.0.1-ext-v3.3 を使用しており、variables.env に次の設定をしています。
これは texlive/texlive:latest-full では問題なく動作します。しかし、別の texlive イメージ danteev/texlive:2025-10-15 を pull し、両方の変数を新しいイメージ名に変更したところ、動作しません。
ログには次のように表示されます。
variables.env の更新された設定が反映されていないようです。コンパイルは新しいイメージではなく、依然として texlive/texlive:latest-full イメージを実行しようとします。 再起動したり、コンテナを削除して再実行したりしましたが、同じ問題が発生します。 何か解決策はありますか?
技術的な制約により、texlive-fullA:latest のように Docker TeX Live イメージを 1 つだけ設定している場合、
しばらく Overleaf インスタンスを運用した後に、TeX Live イメージを texlive-fullB:latest に変更したくなるかもしれません。すると、ユーザーがすべてのプロジェクトをコンパイルできなくなることがわかります。
これは、各プロジェクトの TeX Live Full イメージ(サンドボックスコンパイル用)の名前がデータベースに永続化されているためです。ユーザーがプロジェクトの TeX Live バージョンを切り替えた場合(例えば 2024 から 2025 へ)にのみ、データベース内のイメージ名が変更されます。 CLSI はプロジェクトをコンパイルする際、データベースに記録されているコンテナイメージ名を使用して直接プロジェクトをコンパイルします。 Docker イメージを 1 つしか提供していない場合、ユーザーはプロジェクトのコンパイルに使用するイメージを変更できません。この場合、MongoDB 内のすべてのユーザープロジェクトの TeX Live イメージを手動で変更するスクリプトを作成する必要があります。

デバッグと報告

Toolkit から clsi のログを確認するには、次のコマンドを実行します。
TeX Live イメージでのコンパイルで問題が発生した場合は、こちらから issue を送信してください。 https://github.com/ayaka-notes/texlive-full/issues/new?template=texlive-image-bug.yml 問題の再現とトラブルシューティングのために、プロジェクトを Overleaf にアップロードするようお願いする場合があります。その後、私たちがプロジェクトを取得し、GitHub Action でコンパイルテストを実行します。

Q&A

回答: コンテナとコンパイルファイルは一定時間後に削除されますが、TeX Live イメージは削除されません。
  • コンパイルコンテナ(project-<project id>-<hash>)は同じプロジェクトのコンパイル間で再利用されるため、コンパイル後も残ります。1 時間ごとにチェックが実行され、作成から 1 時間以上経過し、かつ直近 1 時間以内にプロジェクトがコンパイルされていないコンテナが削除されます。コンテナは通常、最後のコンパイルから 1〜2 時間後に削除されます。Overleaf を再起動しても削除されず、次の 1 時間ごとのチェックで削除されます。
  • 単語数カウント、SyncTeX、変換用のコンテナは、完了するとすぐに削除されます。
  • コンパイルファイル(data/overleaf/data/compiles と output)は、プロジェクトが 1 日使用されないと削除されます。チェックは 10 分ごとに行われます。ディスクの空き容量が少なくなると、この期間は段階的に短縮され、最短で半日になります。
  • TeX Live イメージは、すべてのコンパイルで必要となるため、削除されることはありません。ALL_TEX_LIVE_DOCKER_IMAGES からイメージを外した後に容量を解放するには、docker image rm <image> で削除してください。
これらのコンテナを手動で削除する必要はありません。
回答: いいえ。各コンパイルコンテナは自身のプロジェクトのコンパイルディレクトリのみを /compile にマウントし、ネットワークにも接続されていません。また、他のホストディレクトリをマウントする設定もありません。代わりに、プロジェクトに必要なファイルをプロジェクトにアップロードしてください。
回答: はい。ghcr.io/ayaka-notes/texlive-basic:<year>.1(2020.1 から 2026.1)には、TeX Live の basic スキームに加えて、latexmk、xetex、fontspec などのいくつかのパッケージが含まれていますが、フォント一式は含まれていません。texlive-full よりもはるかに小さいですが、他のパッケージを使用するプロジェクトではパッケージ不足のエラーが発生します。TeX Live 2025 basic の場合:
config/variables.env
ghcr.io/ayaka-notes/texlive-full:base は basic イメージではありません。TeX Live が含まれていないため、コンパイルできません。
回答: エディターには表示されず、clsi のログにもデバッグレベルでしか記録されません。ただし、すべてのコンパイルリクエストはこの情報を返します。ブラウザーの開発者ツールを開き、Network タブに移動して再コンパイルし、compile リクエストを選択してください。その JSON レスポンスにはミリ秒単位の timings が含まれており、compileE2E はコンパイルサービスにおけるコンパイル全体、compile は LaTeX の実行そのものの時間です。
最終更新日 2026年11月13日