Перейти до основного вмісту
Компіляція в пісочниці в середовищі розробки працює трохи інакше, ніж у продакшн-образі. У середовищі розробки її вже налаштовано; на цій сторінці пояснено налаштування та три моменти, про які варто пам’ятати:
  • Проблема з правами доступу до файлів
  • Спільний том для 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 р.