Segurança aprimorada
Os Sandboxed Compiles são a abordagem recomendada para o Ayakaleaf Pro, pois muitos documentos LaTeX exigem ou têm a capacidade de executar comandos de shell arbitrários como parte do processo de compilação do PDF. Se você usar Sandboxed Compiles, cada compilação será executada em um contêiner Docker separado, com capacidades limitadas que não são compartilhadas com nenhum outro usuário ou projeto, e sem acesso a recursos externos, como a rede do host.Gerenciamento de pacotes mais fácil
Para evitar a instalação manual de pacotes, recomendamos ativar os Sandboxed Compiles. Essa é uma configuração ajustável no Ayakaleaf Pro que fornecerá aos seus usuários acesso ao mesmo ambiente TeX Live do overleaf.com, mas dentro da sua própria instalação on-premises. As imagens do TeX Live usadas pelos Sandboxed Compiles contêm os pacotes e as fontes mais populares, testados com os templates da nossa galeria, garantindo a máxima compatibilidade com projetos on-premises. Ativar os Sandboxed Compiles permite configurar quais versões do TeX Live os usuários podem escolher dentro de seus projetos, além de definir uma versão padrão da imagem do TeX Live para novos projetos.Se você tentar executar o Ayakaleaf Pro sem Sandboxed Compiles, sua instância usará por padrão uma versão com esquema básico do TeX Live para as compilações. Essa versão básica é leve e contém apenas um subconjunto muito limitado de pacotes LaTeX, o que muito provavelmente resultará em erros de pacotes ausentes para seus usuários, especialmente se tentarem usar templates prontos.
Os Sandboxed Compiles exigem que o contêiner
sharelatex tenha acesso ao socket do Docker na máquina host (por meio de um bind mount), para que possa gerenciar esses contêineres de compilação irmãos.Como funciona
Quando os Sandboxed Compiles estão ativados, o socket do Docker é montado da máquina host no contêinersharelatex, para que o serviço de compilação no contêiner possa criar novos contêineres Docker no host. Em seguida, para cada execução do compilador em cada projeto, o serviço de compilação LaTeX (CLSI) fará o seguinte:
- Gravar os arquivos do projeto em um local dentro do
OVERLEAF_DATA_PATH. - Usar o socket do Docker montado para criar um novo contêiner
texlivepara a execução da compilação. - Fazer com que o contêiner
texliveleia os dados do projeto a partir do local emOVERLEAF_DATA_PATH. - Compilar o projeto dentro do contêiner
texlive.
Ativando os Sandboxed Compiles
Para usuários do Toolkit
Para ativar os Sandboxed Compiles (também conhecidos como Sibling containers), defina as seguintes opções de configuração emoverleaf-toolkit/config/overleaf.rc:
config/overleaf.rc
SIBLING_CONTAINERS_ENABLED=false e execute bin/up. As compilações passam então a ser executadas dentro do contêiner sharelatex com o TeX Live básico dele.
Para usuários do Docker Compose
Configurar a imagem do TeX Live
Para usuários da China continental, é possível baixar as imagens do espelho NÃO use
ghcr.nju.edu.cn para acelerar o download e depois marcá-las com o nome ghcr.io:ghcr.nju.edu.cn nas configurações de ambiente do Toolkit: mantenha ali os nomes ghcr.io. Para impedir que o bin/up baixe as imagens do ghcr.io novamente, defina SIBLING_CONTAINERS_PULL=false em config/overleaf.rc. Para manter as imagens atualizadas por meio do espelho, consulte Atualizar as imagens TeX Live Full automaticamente.TEX_LIVE_DOCKER_IMAGE(opcional), A imagem do TeX Live usada por novos projetos. Ela deve ser uma das imagens emALL_TEX_LIVE_DOCKER_IMAGES. Se não for definida, os novos projetos usam a primeira imagem deALL_TEX_LIVE_DOCKER_IMAGES.ALL_TEX_LIVE_DOCKER_IMAGE_NAMES(opcional), Uma lista separada por vírgulas de nomes para as imagens, na mesma ordem, exibidos nas configurações do compilador. Se não for definida, ou se for menor que a lista de imagens, a imagem é exibida pela sua tag, por exemplo2026.1.ALL_TEX_LIVE_DOCKER_IMAGES(obrigatória), Uma lista separada por vírgulas das imagens do TeX Live a serem usadas. Se o Overleaf Toolkit for usado na implantação, essas imagens serão baixadas ou atualizadas. Para pular o download, definaSIBLING_CONTAINERS_PULL=falseemconfig/overleaf.rc.
bin/up, o Toolkit baixará automaticamente todas as imagens listadas em ALL_TEX_LIVE_DOCKER_IMAGES.
Aqui está um exemplo em que usamos o TeX Live 2026 como padrão para novos projetos e mantemos o 2025 em uso para projetos antigos.
- Instalação mínima
- Instalação completa
A configuração a seguir instala todas as imagens Docker completas do TeX Live de 2025 a 2026. Recomendamos ter pelo menos 64 GB de armazenamento disponível antes de usar esta configuração.
config/variables.env
É altamente recomendável configurar pelo menos 2 imagens texlive-full. Para saber o motivo em detalhes, consulte #known-issues
Imagens do TeX Live disponíveis
Estas são uma série de imagens do TeX Live especialmente otimizadas para o Overleaf, que também podem ser adicionadas aTEX_LIVE_DOCKER_IMAGE e ALL_TEX_LIVE_DOCKER_IMAGES:
ghcr.io/ayaka-notes/texlive-full:2026.1(também com a taglatest)ghcr.io/ayaka-notes/texlive-full:2025.1ghcr.io/ayaka-notes/texlive-full:2024.1ghcr.io/ayaka-notes/texlive-full:2023.1ghcr.io/ayaka-notes/texlive-full:2022.1ghcr.io/ayaka-notes/texlive-full:2021.1ghcr.io/ayaka-notes/texlive-full:2020.1
Posso usar outro registro de imagens?
Algumas pessoas podem se perguntar se é possível substituir ghcr.io por outro site espelho, ou trocar o texlive por outra imagem do Docker Hub.
Não recomendamos, pois a configuração é relativamente complicada. Se você estiver baixando de um site espelho, pode renomear sua imagem para ghcr.io/ayaka-notes/texlive-full.
Mas, se você realmente quiser usar seu próprio registro de imagens, adicione:
config/variables.env
your-repo, como
hub.your.com/your-repo/texlive-full:2025.1hub.your.com/your-repo/texlive-full:2024.1
sandboxed-compiles/index.mjs
Sincronização automatizada das imagens do TeX Live
Para evitar ter que atualizar manualmente sua instância combin/up toda vez, você pode automatizar as atualizações da sua imagem do TeX Live. Consulte updating-tex-live-full-images-automatically.md.
Problemas conhecidos
Este é um caso real da comunidade do Overleaf:Usando a6.0.1-ext-v3.3, tenho estas configurações emvariables.env:Isso funciona bem comtexlive/texlive:latest-full. No entanto, baixei outra imagem do texlive,danteev/texlive:2025-10-15, e alterei ambas as variáveis para o novo nome da imagem, mas não funciona:Nos logs, vejo o seguinte:
Parece que as configurações atualizadas emDevido a algumas limitações técnicas, se você configurar apenas uma única imagem Docker do TeXLive, comovariables.envnão estão surtindo efeito. A compilação ainda tenta executar a imagemtexlive/texlive:latest-full, e não a nova imagem. Tentei reiniciar, excluir os contêineres e executar novamente, mas o problema continua o mesmo. Alguma solução?
texlive-fullA:latest
texlive-fullB:latest. Então, verá que seus usuários não conseguem compilar nenhum projeto.
Depuração e relato de problemas
Execute o seguinte comando para verificar o log do clsi a partir do Toolkit:Q&A
Os contêineres de sandbox, os arquivos de compilação e as imagens do TeX Live são removidos automaticamente?
Os contêineres de sandbox, os arquivos de compilação e as imagens do TeX Live são removidos automaticamente?
Resposta: Os contêineres e os arquivos de compilação são, após um intervalo; as imagens do TeX Live não.
- Contêineres de compilação (
project-<project id>-<hash>) são reutilizados entre compilações do mesmo projeto, por isso permanecem após uma compilação. Uma verificação é executada a cada hora e remove os que têm mais de uma hora e cujo projeto não foi compilado na última hora. Um contêiner normalmente desaparece de uma a duas horas após a última compilação. Reiniciar o Overleaf não os remove; a próxima verificação horária, sim. - Contêineres de contagem de palavras, SyncTeX e conversão são removidos assim que terminam.
- Arquivos de compilação (
data/overleaf/data/compileseoutput) são removidos quando um projeto não é usado há um dia, com verificação a cada 10 minutos. Quando o espaço em disco fica baixo, esse período é reduzido gradualmente, até meio dia. - Imagens do TeX Live nunca são removidas, pois toda compilação precisa delas. Para liberar espaço depois de remover uma imagem de
ALL_TEX_LIVE_DOCKER_IMAGES, exclua-a comdocker image rm <image>.
Um projeto pode ler arquivos de um diretório do host ou de um NAS?
Um projeto pode ler arquivos de um diretório do host ou de um NAS?
Resposta: Não. Cada contêiner de compilação monta apenas o diretório de compilação do próprio projeto, em
/compile, e não tem rede, e não há nenhuma configuração para montar outros diretórios do host nele. Em vez disso, envie para o projeto os arquivos de que ele precisa.Existe uma imagem básica do TeX Live e como configurá-la?
Existe uma imagem básica do TeX Live e como configurá-la?
Resposta: Sim.
ghcr.io/ayaka-notes/texlive-basic:<year>.1 (2020.1 a 2026.1) tem o esquema básico do TeX Live mais alguns pacotes, como latexmk, xetex e fontspec, sem o conjunto completo de fontes. Ela é muito menor que a texlive-full, mas projetos que usam outros pacotes recebem erros de pacote ausente. Para o TeX Live 2025 básico:config/variables.env
ghcr.io/ayaka-notes/texlive-full:base não é uma imagem básica: ela não contém o TeX Live e não consegue compilar.Onde posso ver quanto tempo uma compilação levou?
Onde posso ver quanto tempo uma compilação levou?
Resposta: O editor não mostra essa informação, e o log do
clsi só a registra no nível de depuração. Ainda assim, toda requisição de compilação a retorna: abra as ferramentas de desenvolvedor do navegador, vá até a aba Network, recompile e selecione a requisição compile. Sua resposta JSON contém timings em milissegundos, onde compileE2E é a compilação inteira no serviço de compilação e compile é a própria execução do LaTeX.
