> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/texlive/ja/dockernotexlive.md).
# Docker内のTeXLive
### Docker
Docker は、アプリケーションを分離されたコンテナにパッケージ化して実行するための、軽量でポータブルな方法を提供します。アプリケーションを必要な依存関係すべてと一緒にまとめることで、コンテナはノートパソコンから本番サーバーまで、さまざまなマシン間で一貫した動作を保証します。
TeX Live は強力ですが大規模で、システムレベルの違いに敏感です。TeX Live を Docker イメージ内にパッケージ化することで、LaTeX ツールチェーンは予測可能で再現性があり、配布もしやすくなります。
しかし、いくつかの TeX Live パッケージはシェルアクセスに依存しています。セキュリティ上の理由から、コンテナは、ユーザーが任意のシェルコマンドを実行できない制限された環境で実行されるべきです（たとえば `\write18` や shell escape 経由）。この分離によりホストシステムを保護し、コンテナの基盤となるファイルシステムや、次のようなツールへの意図しないアクセスを防ぎます。 `bash`.
### TeX Live フルエディション
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) はフル機能の **TeXLive Docker イメージ** で、Overleaf Server Pro、Overleaf Pro、さらに CI やパイプラインのような単独の LaTeX コンパイル環境向けに特別に設計されています。
このイメージは、一般的なフォントとツールをあらかじめインストールした、ほぼ完全な TeX Live ディストリビューションを提供することを目指しており、パッケージやフォントの不足によるコンパイル失敗を最小限に抑えます。
特徴:
* 🚀 x86\_64 と arm64 の両方のサーバーアーキテクチャをサポート
* 📦 完全で最適化された TeX Live のインストール
* 🧩 一般的なフォントとユーティリティをプリインストール
* 🐳 Docker と Docker Compose ですぐに使える
* 🧪 Overleaf Server Pro / Overleaf Pro でテスト済み
* 🔄 最新の TeX Live リリースで定期的に更新
* 🏷 複数の TeX Live バージョンタグ（2020 – 最新）
* 🧑🔬 LaTeX 文書内の R コード向け Knitr サポート
### Overleaf Pro の使用方法
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) サポート **Overleaf Pro**では、以下の環境変数を使って `config/variables.env` ファイルを [toolkit ユーザー](https://github.com/overleaf/toolkit).
たとえば:
{% code title="config/variables.env" overflow="wrap" %}
```dotenv
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2025.1, ghcr.io/ayaka-notes/texlive-full:2024.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2025, Texlive 2024
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2025.1
```
{% endcode %}
### TeX Live バージョン
Github Action により、次を含むすべての tex イメージを並列でビルドできます。
* `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`
* `ghcr.io/ayaka-notes/texlive-full:base`
次のミラーアーカイブを使用しています。 [texlive 情報](https://texlive.info/tlnet-archive/)には、1996 年から 2026 年までのほぼすべての texlive イメージが含まれています。また、Overleaf の Dockerfile のおかげで、このプロジェクトをより速くビルドできます。
> なぜ texlive 2019 以前はサポートされていないのですか？
>
> そのようなイメージを維持するのは非常に困難です。また、古すぎるため、もう使わないだろうと考えています。必要であれば issue を開いて知らせてください。
### 含まれるコンポーネント
以下のパッケージが docker イメージに含まれています。
* すべての TeX Live パッケージ（その年のもの）
* R パッケージ（選択済みのみ）
* fontconfig inkscape pandoc python3-pygments wget python3
* gnupg gnuplot perl-modules perl ca-certificates
* ghostscript qpdf r-base-core tar
以下のフォントが docker イメージに含まれています。
* [Google Fonts](https://fonts.google.com/)
* [Microsoft msttcorefonts](https://packages.ubuntu.com/jammy/ttf-mscorefonts-installer)
* [Overleaf 対応フォント](https://www.overleaf.com/learn/latex/Questions/Which_OTF_or_TTF_fonts_are_supported_via_fontspec%3F)
{% hint style="warning" %}
関連するフォントが商用利用可能かどうかを必ず確認してください。私たちは **責任を負いません** フォントの誤った使用から生じる法的問題については責任を負いません。イメージをダウンロードした時点で、あなたはこれに自動的に同意したものとみなされます。
{% endhint %}
### ライセンス
MIT
### 問題
問題 01: フォントキャッシュの見つからない問題
Overleaf で LaTeX プロジェクトをコンパイルするときにフォントが見つからないと、 **コンパイルの進行に長い時間がかかることがあります。**これは、フォントが見つからない場合に texlive が **フォントキャッシュ全体を再構築しようとする**ためです。これは時間のかかる処理です。
このイメージではフォントキャッシュを事前構築しており、この問題は [このコミット](https://github.com/ayaka-notes/texlive-full/commit/0cb66b0dc8b82be628cf6999cfd659d9784e132f)
問題 02: Sync TeX が非常に遅い
このイメージを sharelatex で使うと、Sync TeX が非常に遅いことに気づくかもしれません。
参照: 。HTTP/2.0 を無効にするだけです。
問題 03: 公式 Texlive イメージでの再コンパイルエラー
docker hub 上の texlive 公式イメージを使う場合、 `texlive/texlive`プロジェクトを再コンパイルするとエラーが報告されることがあります。しかし、このイメージではこの問題は修正されています。最新の Ubuntu ベースイメージを使用し、依存関係をすべて Ubuntu 公式リポジトリからインストールしているためです。
### その他の技術メモ
texlive イメージ（2019 年以前）をビルドする際は、次の問題に注意する必要があります。
* 2017 年以前は `http`/`ftp` のみがサポートされているため、 `https` を使ってダウンロードすることはできません。 `peal` スクリプト
* 。2015 年以前は sha256 ファイルのみが提供されています。そのため、sha512 を使って確認することはできません。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ayakaleaf-pro.ayaka.space/texlive/ja/dockernotexlive.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.