> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/texlive/ko/docker-texlive.md).
# Docker에서 TeXLive
### Docker
Docker는 애플리케이션을 격리된 컨테이너에서 패키징하고 실행할 수 있는 가볍고 이동성이 뛰어난 방식을 제공합니다. 애플리케이션을 필요한 모든 의존성과 함께 묶음으로써, 컨테이너는 노트북부터 프로덕션 서버까지 다양한 머신에서 일관된 동작을 보장합니다.
TeX Live는 강력하지만 용량이 크고 시스템 수준의 차이에 민감합니다. TeX Live를 Docker 이미지 안에 패키징하면 LaTeX 툴체인이 예측 가능하고 재현 가능하며 배포하기 쉬워집니다.
그러나 일부 TeX Live 패키지는 셸 접근에 의존합니다. 보안상의 이유로, 컨테이너는 사용자가 임의의 셸 명령을 실행하지 못하도록 제한된 환경에서 실행되어야 합니다(예를 들어 `\write18` 또는 셸 이스케이프). 이 격리는 호스트 시스템을 보호하고, 컨테이너의 기반 파일 시스템이나 다음과 같은 도구에 대한 의도치 않은 접근을 방지합니다. `bash`.
### TeXLive 전체 에디션
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) 는 모든 기능을 갖춘 **TeXLive Docker 이미지** 로, Overleaf Server Pro, Overleaf Pro는 물론 CI나 파이프라인 같은 독립형 LaTeX 컴파일 환경을 위해 특별히 설계되었습니다.
이 이미지는 누락된 패키지나 글꼴로 인한 컴파일 실패를 최소화하기 위해, 일반적인 글꼴과 도구가 사전 설치된 거의 완전한 TeXLive 배포판을 제공하는 것을 목표로 합니다.
특징:
* 🚀 x86\_64 및 arm64 서버 아키텍처를 모두 지원
* 📦 완전하고 최적화된 TeXLive 설치
* 🧩 일반적인 글꼴과 유틸리티 사전 설치
* 🐳 Docker 및 Docker Compose와 함께 바로 사용 가능
* 🧪 Overleaf Server Pro / Overleaf Pro에서 테스트됨
* 🔄 최신 TeXLive 릴리스로 정기적으로 업데이트
* 🏷 여러 TeXLive 버전 태그(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 %}
### TeXLive 버전
GitHub Action 덕분에, 다음을 포함한 모든 tex 이미지를 병렬로 빌드할 수 있습니다:
* `ghcr.io/ayaka-notes/texlive-full:2026.1` (또한 `최신` 태그)
* `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 및 그 이전은 지원되지 않나요?
>
> 그런 이미지를 유지하는 것은 매우 어렵습니다. 그리고 너무 오래되어 더 이상 사용하지 않을 것이라 생각합니다. 필요하다면 이슈를 열어 알려 주세요.
### 포함된 구성 요소
다음 패키지들이 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](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년 이전), 다음 문제에 주의해야 할 수 있습니다:
* 오직 `http`/`ftp` 만 texlive 2017 이전에는 지원되므로, 다음을 사용할 수 없습니다 `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://overleaf-pro.ayaka.space/texlive/ko/docker-texlive.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.