Перейти к основному содержанию
Компиляция в песочнице в среде разработки работает немного иначе, чем в продакшен-образе. В среде разработки она уже настроена; на этой странице описаны настройки и три момента, о которых нужно помнить:
  • Проблема с правами доступа к файлам
  • Общий том для history-v1 и filestore
  • Проблема с подкаталогами

Включение изолированной компиляции

Компиляция в песочнице включена по умолчанию. develop/docker-compose.yml задаёт SANDBOXED_COMPILES=true для clsi, а develop/dev.env содержит остальное:
develop/dev.env
clsi не загружает образы сам, поэтому загрузите их один раз командой 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).
По умолчанию filestore выступает посредником между S3 и другими сервисами Overleaf. Однако в Overleaf CE или Server Pro все файлы по умолчанию хранятся локально. Поэтому в Overleaf применён весьма хитрый приём.
server-ce/config/settings.js
При этом data/history также используется сервисом истории. Так разные микросервисы могут совместно использовать одни и те же данные. Поэтому сервис filestore в develop монтирует том history-v1-buckets сервиса history-v1. Без него clsi не сможет получать blob-файлы из сервиса filestore.
develop/docker-compose.yml
filestore находит бакеты через эти настройки в 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
Без этого history-v1 хранит файлы project_blobs так:
Когда useSubdirectories равно true, символ _ в этих именах становится /, поэтому каждый blob хранится во вложенных папках.
Последнее изменение 20 ноября 2026 г.