Hoppa till huvudinnehåll
Sandlådekompileringar fungerar lite annorlunda i utvecklingsmiljön än i produktionsavbildningen. Utvecklingsmiljön har redan konfigurerat dem; den här sidan förklarar inställningarna och tre saker att tänka på:
  • Problem med filbehörigheter
  • Delad volym mellan history-v1 och filestore
  • Problem med underkataloger

Aktivera kompilering i sandlåda

Sandlådekompileringar är på som standard. develop/docker-compose.yml sätter SANDBOXED_COMPILES=true för clsi, och develop/dev.env innehåller resten:
develop/dev.env
clsi hämtar inte avbildningar själv, så hämta avbildningarna en gång med docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (och :2025.1). LaTeX körs i syskoncontainrarna som TEXLIVE_IMAGE_USER. I utvecklingsmiljön är det tex, vilket också är standard för clsi (services/clsi/config/settings.defaults.cjs:154). Produktionsavbildningen använder i stället www-data när SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), eftersom filerna där skapas av användaren www-data i Overleaf-containern.
Använd inte en egenbyggd image, eftersom du då kan stöta på en rad fel.

Åtgärda filbehörigheter

clsi-containern startar som root, ger mapparna compiles, output och cache till användaren node (uid 1000) och kör sedan clsi som node (services/clsi/entrypoint.sh). Därför tillhör develop/compiles på värden uid 1000, samma uid som tex i utvecklingsmiljön (se kommentaren i develop/pandoc/Dockerfile). Med inställningarna ovan kompilerar utvecklingsmiljön utan någon ändring av behörigheter. Om du i stället sätter TEXLIVE_IMAGE_USER=root har root (uid 0) inte behörighet att skriva till undermapparna i compiles. Ge i så fall gruppen root ägarskap och skrivbehörighet till compiles, med setgid satt så att nya undermappar ärver detta ägarskap:
bash
Detaljerad dokumentation finns i services/clsi/README.md.

Delad volym mellan history-v1 och filestore

Inställningarna i det här avsnittet och nästa finns redan i develop/docker-compose.yml och develop/dev.env. De spelar bara roll med S3_ENABLED=false i develop/dev.rc. Med standardvärdet S3_ENABLED=true lagrar filestore och history-v1 i stället dessa filer i RustFS-buckets (develop/s3/docker-compose.yml).
Som standard fungerar filestore som en brygga mellan S3 och övriga tjänster i Overleaf. I Overleaf CE eller Server Pro lagras dock alla filer lokalt som standard. Därför har Overleaf infört en ganska knepig metod.
server-ce/config/settings.js
Samtidigt används data/history också av historiktjänsten. På så sätt kan olika mikrotjänster dela samma data. Därför monterar filestore-tjänsten i develop volymen history-v1-buckets från history-v1. Utan den kan clsi inte hämta blobfiler från filestore-tjänsten.
develop/docker-compose.yml
filestore hittar bucketarna via de här inställningarna i dev.env:
develop/dev.env

Använd underkataloger

filestore läser alltid historikblobbar med underkataloger (services/filestore/app/js/KeyBuilder.js:58, :70). Produktionsavbildningen slår på useSubdirectories för history-v1 (server-ce/config/production.json), men standardkonfigurationen för history-v1 gör det inte, så i utveckling skulle history-v1 platta till all data. Därför sätter dev.env NODE_CONFIG för history-v1:
develop/dev.env
Utan den lagrar history-v1 project_blobs-filerna så här:
När useSubdirectories är satt till true blir _ i dessa namn /, så att varje blob lagras i undermappar.
Senast ändrad 20 november 2026