- Проблема с правами доступа к файлам
- Общий том для history-v1 и filestore
- Проблема с подкаталогами
Включение изолированной компиляции
Компиляция в песочнице включена по умолчанию.develop/docker-compose.yml задаёт SANDBOXED_COMPILES=true для clsi, а develop/dev.env содержит остальное:
develop/dev.env
docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (и :2025.1).
LaTeX работает в соседних контейнерах от имени TEXLIVE_IMAGE_USER. В среде разработки это tex, что также является значением по умолчанию для clsi (services/clsi/config/settings.defaults.cjs:154). Продакшен-образ вместо этого использует www-data, когда SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), потому что там файлы создаёт пользователь www-data контейнера Overleaf.
Исправление прав доступа к файлам
Контейнер clsi запускается от root, передаёт папкиcompiles, output и cache пользователю node (uid 1000), а затем запускает clsi от имени node (services/clsi/entrypoint.sh). Поэтому develop/compiles на хосте принадлежит uid 1000, тому же uid, что и у tex в среде разработки (см. комментарий в develop/pandoc/Dockerfile). С приведёнными выше настройками среда разработки компилирует без каких-либо изменений прав.
Если вместо этого задать TEXLIVE_IMAGE_USER=root, у root (uid 0) нет прав на запись в подпапки compiles. В этом случае передайте группе root владение и право записи на compiles и установите setgid, чтобы новые подпапки наследовали это владение:
bash
services/clsi/README.md.
Общий том для history-v1 и filestore
Настройки из этого и следующего раздела уже есть в
develop/docker-compose.yml и develop/dev.env. Они важны только при S3_ENABLED=false в develop/dev.rc. При значении по умолчанию S3_ENABLED=true filestore и history-v1 хранят эти файлы в бакетах RustFS (develop/s3/docker-compose.yml).server-ce/config/settings.js
data/history также используется сервисом истории. Так разные микросервисы могут совместно использовать одни и те же данные. Поэтому сервис filestore в develop монтирует том history-v1-buckets сервиса history-v1. Без него clsi не сможет получать blob-файлы из сервиса filestore.
develop/docker-compose.yml
dev.env:
develop/dev.env
Использование подкаталогов
filestore всегда читает blob-объекты истории с подкаталогами (services/filestore/app/js/KeyBuilder.js:58, :70). Продакшен-образ включает useSubdirectories для history-v1 (server-ce/config/production.json), а конфигурация history-v1 по умолчанию нет, поэтому в разработке history-v1 сделал бы все данные плоскими. Поэтому dev.env задаёт NODE_CONFIG для history-v1:
develop/dev.env
project_blobs так:
useSubdirectories равно true, символ _ в этих именах становится /, поэтому каждый blob хранится во вложенных папках.
