Zum Hauptinhalt springen
Sandbox-Kompilierungen funktionieren in der Entwicklungsumgebung etwas anders als im Produktions-Image. Die Entwicklungsumgebung hat sie bereits eingerichtet; diese Seite erklärt die Einstellungen und drei Punkte, die Sie beachten sollten:
  • Problem mit Dateiberechtigungen
  • Gemeinsames Volume zwischen history-v1 und filestore
  • Problem mit Unterverzeichnissen

Sandbox-Kompilierung aktivieren

Sandbox-Kompilierungen sind standardmäßig aktiviert. develop/docker-compose.yml setzt SANDBOXED_COMPILES=true für clsi, und develop/dev.env enthält den Rest:
develop/dev.env
clsi lädt Images nicht selbst herunter, laden Sie die Images daher einmal mit docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (und :2025.1) herunter. LaTeX läuft in den Geschwister-Containern als TEXLIVE_IMAGE_USER. In der Entwicklungsumgebung ist das tex, was auch der Standard von clsi ist (services/clsi/config/settings.defaults.cjs:154). Das Produktions-Image verwendet stattdessen www-data, wenn SANDBOXED_COMPILES_SIBLING_CONTAINERS=true gesetzt ist (server-ce/config/env.sh:15-21), weil dort die Dateien vom Benutzer www-data des Overleaf-Containers erstellt werden.
Bitte verwenden Sie kein selbst gebautes Image, da sonst eine Reihe von Fehlern auftreten kann.

Dateiberechtigungen korrigieren

Der clsi-Container startet als root, übergibt die Ordner compiles, output und cache an den Benutzer node (uid 1000) und führt clsi dann als node aus (services/clsi/entrypoint.sh). Daher gehört develop/compiles auf dem Host der uid 1000, derselben uid wie tex in der Entwicklungsumgebung (siehe den Kommentar in develop/pandoc/Dockerfile). Mit den obigen Einstellungen kompiliert die Entwicklungsumgebung ohne jede Änderung der Berechtigungen. Wenn Sie stattdessen TEXLIVE_IMAGE_USER=root setzen, hat root (uid 0) keine Berechtigung, in die Unterordner von compiles zu schreiben. Geben Sie in diesem Fall der Gruppe root den Besitz und Schreibrechte für compiles und setzen Sie setgid, damit neue Unterordner diesen Besitz erben:
bash
Eine ausführliche Dokumentation finden Sie in services/clsi/README.md.

Gemeinsames Volume zwischen history-v1 und filestore

Die Einstellungen in diesem und dem nächsten Abschnitt sind bereits in develop/docker-compose.yml und develop/dev.env enthalten. Sie spielen nur mit S3_ENABLED=false in develop/dev.rc eine Rolle. Mit dem Standard S3_ENABLED=true legen filestore und history-v1 diese Dateien stattdessen in RustFS-Buckets ab (develop/s3/docker-compose.yml).
Standardmäßig fungiert filestore als Brücke zwischen S3 und anderen Diensten in Overleaf. In Overleaf CE oder Server Pro werden jedoch standardmäßig alle Dateien lokal gespeichert. Daher hat Overleaf eine recht trickreiche Methode eingeführt.
server-ce/config/settings.js
Gleichzeitig wird data/history auch vom History-Dienst verwendet. Auf diese Weise können verschiedene Microservices dieselben Daten gemeinsam nutzen. Deshalb bindet der filestore-Dienst in develop das Volume history-v1-buckets von history-v1 ein. Ohne dieses Volume kann clsi keine Blob-Dateien vom filestore-Dienst abrufen.
develop/docker-compose.yml
filestore findet die Buckets über diese Einstellungen in dev.env:
develop/dev.env

Unterverzeichnisse verwenden

filestore liest History-Blobs immer mit Unterverzeichnissen (services/filestore/app/js/KeyBuilder.js:58, :70). Das Produktions-Image schaltet useSubdirectories für history-v1 ein (server-ce/config/production.json), die Standardkonfiguration von history-v1 jedoch nicht, sodass history-v1 in der Entwicklung alle Daten flach ablegen würde. dev.env setzt daher NODE_CONFIG für history-v1:
develop/dev.env
Ohne diese Einstellung speichert history-v1 die project_blobs-Dateien so:
Wenn useSubdirectories auf true gesetzt ist, wird der _ in diesen Namen zu /, sodass jeder Blob in Unterordnern gespeichert wird.
Zuletzt geändert am 20. November 2026