Przejdź do głównej treści
Kompilacje w piaskownicy działają w środowisku deweloperskim nieco inaczej niż w obrazie produkcyjnym. Środowisko deweloperskie ma je już skonfigurowane; ta strona wyjaśnia ustawienia i trzy kwestie, o których warto pamiętać:
  • Problem z uprawnieniami do plików
  • Współdzielenie wolumenu między history-v1 a filestore
  • Problem z podkatalogami

Włączanie Sandbox Compiles

Kompilacje w piaskownicy są domyślnie włączone. develop/docker-compose.yml ustawia SANDBOXED_COMPILES=true dla clsi, a develop/dev.env zawiera resztę:
develop/dev.env
clsi nie pobiera obrazów samodzielnie, więc pobierz je raz poleceniem docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (oraz :2025.1). LaTeX działa w kontenerach siostrzanych jako TEXLIVE_IMAGE_USER. W środowisku deweloperskim jest to tex, który jest też domyślną wartością clsi (services/clsi/config/settings.defaults.cjs:154). Obraz produkcyjny używa zamiast tego www-data, gdy SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), ponieważ tam pliki tworzy użytkownik www-data kontenera Overleaf.
Nie używaj własnoręcznie zbudowanego obrazu — możesz napotkać szereg błędów.

Naprawa uprawnień do plików

Kontener clsi uruchamia się jako root, przekazuje foldery compiles, output i cache użytkownikowi node (uid 1000), a następnie uruchamia clsi jako node (services/clsi/entrypoint.sh). Dlatego develop/compiles na hoście należy do uid 1000, tego samego uid co tex w środowisku deweloperskim (zobacz komentarz w develop/pandoc/Dockerfile). Przy powyższych ustawieniach środowisko deweloperskie kompiluje bez żadnej zmiany uprawnień. Jeśli zamiast tego ustawisz TEXLIVE_IMAGE_USER=root, root (uid 0) nie ma uprawnień do zapisu w podfolderach compiles. W takim przypadku nadaj grupie root własność i prawo zapisu do compiles, z ustawionym setgid, aby nowe podfoldery dziedziczyły tę własność:
bash
Szczegółową dokumentację znajdziesz w pliku services/clsi/README.md.

Współdzielenie wolumenu między history-v1 a filestore

Ustawienia z tej i następnej sekcji są już w develop/docker-compose.yml i develop/dev.env. Mają znaczenie tylko przy S3_ENABLED=false w develop/dev.rc. Przy domyślnym S3_ENABLED=true filestore i history-v1 przechowują te pliki w bucketach RustFS (develop/s3/docker-compose.yml).
Domyślnie filestore pełni rolę pomostu między S3 a innymi usługami w Overleaf. Jednak w Overleaf CE lub Server Pro wszystkie pliki są domyślnie przechowywane lokalnie. Dlatego Overleaf wprowadził dość nietypowe rozwiązanie.
server-ce/config/settings.js
Jednocześnie data/history jest też używany przez usługę historii. Dzięki temu różne mikrousługi mogą współdzielić te same dane. Dlatego usługa filestore w develop montuje wolumin history-v1-buckets z history-v1. Bez niego clsi nie będzie mógł pobierać plików blob z usługi filestore.
develop/docker-compose.yml
filestore znajduje buckety dzięki tym ustawieniom w dev.env:
develop/dev.env

Używanie podkatalogów

filestore zawsze odczytuje bloby historii z podkatalogami (services/filestore/app/js/KeyBuilder.js:58, :70). Obraz produkcyjny włącza useSubdirectories dla history-v1 (server-ce/config/production.json), ale domyślna konfiguracja history-v1 tego nie robi, więc w środowisku deweloperskim history-v1 spłaszczyłby wszystkie dane. Dlatego dev.env ustawia NODE_CONFIG dla history-v1:
develop/dev.env
Bez tego history-v1 zapisuje pliki project_blobs w ten sposób:
Gdy useSubdirectories ma wartość true, znak _ w tych nazwach zmienia się w /, więc każdy blob jest zapisywany w podfolderach.
Ostatnia modyfikacja 20 listopada 2026