Docker 中的 TeX Live

​

Docker

Docker 提供一種輕量且可攜的方式，將應用程式封裝並在隔離的容器中執行。透過將應用程式與所有必要的相依項目打包在一起，容器能確保在不同機器上（從筆記型電腦到正式環境伺服器）都有一致的行為。

TeX Live 功能強大，但體積龐大，且容易受到系統層級差異的影響。將 TeX Live 封裝在 Docker 映像檔中，能讓 LaTeX 工具鏈變得可預期、可重現，且易於散布。

然而，某些 TeX Live 套件需要依賴 shell 存取。基於安全考量，容器應在受限的環境中執行，以防止使用者執行任意 shell 指令（例如透過 \write18 或 shell escape）。這種隔離能保護主機系統，並避免對容器底層檔案系統或 bash 等工具的非預期存取。

​

TeXLive 完整版

TeXLive-Full@ayaka-notes 是一個功能完整的 TeXLive Docker 映像檔，專為 Ayakaleaf Pro、Overleaf CEP 中的沙箱 LaTeX 編譯，或獨立的 LaTeX 編譯環境所設計。

此映像檔旨在提供近乎完整的 TeXLive 發行版，並預先安裝常用字型與工具，以盡量減少因缺少套件或字型而導致的編譯失敗。注意：此 Docker 映像檔不包含任何 sharelatex/overleaf 元件，它是供 Overleaf/Overleaf Pro 編譯使用的。

​

特色：

• 🚀 同時支援 x86_64 與 arm64 伺服器架構
• 📦 完整且經過最佳化的 TeXLive 安裝
• 🧩 預先安裝常用字型與工具程式
• 🐳 可直接搭配 Docker 與 Docker Compose 使用
• 🧪 已通過 Overleaf Server Pro / Overleaf Pro 測試
• 🔄 定期隨最新的 TeXLive 版本更新
• 🏷 提供多個 TeXLive 版本標籤（2020 – 最新版）
• 🧑‍🔬 支援在 LaTeX 文件中使用 Knitr 執行 R 程式碼

​

Ayakaleaf Pro 使用方式

由 Ayaka-notes 提供的 TeX Live Full 是專為 ayakaleaf-pro 設計的。如果你是 Toolkit 使用者，可以在 config/variables.env 檔案中加入以下環境變數。

例如：

config/variables.env

ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1

​

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 info 的鏡像封存庫，其中幾乎包含了從 1996 年到 2025 年的所有 TeX Live 版本。此外，多虧了 Overleaf 的 Dockerfile，我們能更快地建置此專案。

為什麼不支援 TeX Live 2019 及更早的版本？

維護這些舊映像檔極為困難。此外，texlive.info 網站並未提供 2019 年以前發布之 TeX Live 版本的資訊，因此我們無法為這些版本建置映像檔。如果你需要特定的舊版本，請提出 issue 告訴我們。

​

包含的元件

Docker 映像檔中包含以下套件。

• 所有 TeXLive 套件（該年度）
• R 套件（僅限部分）
• fontconfig inkscape pandoc python3-pygments wget python3
• gnupg gnuplot perl-modules perl ca-certificates
• ghostscript qpdf r-base-core tar

Docker 映像檔中包含以下字型。

• Google Fonts
• Microsoft msttcorefonts
• Overleaf 支援的字型

請確認相關字型是否可用於商業用途。對於因你不當使用字型而產生的任何法律問題，我們概不負責。一旦你下載映像檔，即視為自動同意此條款。

​

授權條款

MIT

​

常見問題

問題 01：字型快取未命中問題

Overleaf 編譯 LaTeX 專案時，若發生字型缺失，你可能會發現編譯過程耗時很長，這是因為當字型缺失時，TeX Live 會嘗試重建整個字型快取，而這是一個相當耗時的過程。

在我們的映像檔中，已預先建置好字型快取，並透過這個 commit 修正了此問題。

問題 02：SyncTeX 極為緩慢

當你在 sharelatex 中使用此映像檔時，可能會發現 SyncTeX 極為緩慢。

請參閱：https://github.com/overleaf/overleaf/issues/1150，只要停用 HTTP 2.0 即可。

問題 03：使用官方 TeX Live 映像檔時的重新編譯錯誤

如果你使用 Docker Hub 上的 TeX Live 官方映像檔 texlive/texlive，可能會發現重新編譯專案時會回報錯誤。不過，我們的映像檔已修正此問題，因為我們使用最新的 Ubuntu 基礎映像檔，並從 Ubuntu 官方套件庫安裝所有相依項目。

​

其他技術提醒

建置 TeX Live 映像檔（2019 年以前的版本）時，你可能需要留意以下問題：

• TeX Live 2017 以前僅支援 http/ftp，因此除非修改 peal 腳本，否則無法使用 https 下載。
• 2015 年以前僅提供 sha256 檔案，因此無法使用 sha512 進行檢查。