Langsung ke konten utama
Kompilasi sandbox bekerja sedikit berbeda di lingkungan pengembangan dibandingkan di image produksi. Lingkungan pengembangan sudah menyiapkannya; halaman ini menjelaskan pengaturannya dan tiga hal yang perlu diperhatikan:
  • Masalah izin file
  • Berbagi volume antara history-v1 dan filestore
  • Masalah subdirektori

Mengaktifkan Sandbox Compiles

Kompilasi sandbox aktif secara default. develop/docker-compose.yml menetapkan SANDBOXED_COMPILES=true untuk clsi, dan develop/dev.env berisi sisanya:
develop/dev.env
clsi tidak menarik image sendiri, jadi tarik image sekali dengan docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (dan :2025.1). LaTeX berjalan di container saudara sebagai TEXLIVE_IMAGE_USER. Di lingkungan pengembangan, nilainya tex, yang juga merupakan default clsi (services/clsi/config/settings.defaults.cjs:154). Image produksi menggunakan www-data sebagai gantinya ketika SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), karena di sana file dibuat oleh pengguna www-data dari container Overleaf.
Jangan gunakan image yang Anda bangun sendiri, karena Anda mungkin akan menemui serangkaian error.

Memperbaiki Izin File

Container clsi dimulai sebagai root, memberikan folder compiles, output, dan cache kepada pengguna node (uid 1000), lalu menjalankan clsi sebagai node (services/clsi/entrypoint.sh). Jadi develop/compiles di host dimiliki oleh uid 1000, uid yang sama dengan tex di lingkungan pengembangan (lihat komentar di develop/pandoc/Dockerfile). Dengan pengaturan di atas, lingkungan pengembangan mengompilasi tanpa perubahan izin apa pun. Jika Anda menetapkan TEXLIVE_IMAGE_USER=root sebagai gantinya, root (uid 0) tidak memiliki izin menulis ke subfolder compiles. Dalam hal itu, berikan grup root kepemilikan dan izin menulis pada compiles, dengan setgid diaktifkan agar subfolder baru mewarisi kepemilikan ini:
bash
Untuk dokumentasi lebih rinci, Anda dapat melihat services/clsi/README.md.

Berbagi Volume antara history-v1 dan filestore

Pengaturan di bagian ini dan bagian berikutnya sudah ada di develop/docker-compose.yml dan develop/dev.env. Pengaturan ini hanya berpengaruh dengan S3_ENABLED=false di develop/dev.rc. Dengan default S3_ENABLED=true, filestore dan history-v1 menyimpan file ini di bucket RustFS sebagai gantinya (develop/s3/docker-compose.yml).
Secara default, filestore berfungsi sebagai jembatan antara S3 dan layanan lain di Overleaf. Namun, di Overleaf CE atau Server Pro, semua file disimpan secara lokal secara default. Karena itu, Overleaf memperkenalkan metode yang cukup rumit.
server-ce/config/settings.js
Sementara itu, data/history juga digunakan oleh layanan riwayat. Dengan cara ini, berbagai microservice dapat berbagi data yang sama. Itulah sebabnya layanan filestore di develop memasang volume history-v1-buckets milik history-v1. Tanpa volume itu, clsi tidak akan dapat menarik file blob dari layanan filestore.
develop/docker-compose.yml
filestore menemukan bucket melalui pengaturan berikut di dev.env:
develop/dev.env

Menggunakan Subdirektori

filestore selalu membaca blob riwayat dengan subdirektori (services/filestore/app/js/KeyBuilder.js:58, :70). Image produksi mengaktifkan useSubdirectories untuk history-v1 (server-ce/config/production.json), tetapi konfigurasi default history-v1 tidak, sehingga dalam pengembangan history-v1 akan meratakan semua data. Karena itu dev.env menetapkan NODE_CONFIG untuk history-v1:
develop/dev.env
Tanpa pengaturan itu, history-v1 menyimpan file project_blobs seperti ini:
Dengan useSubdirectories bernilai true, _ dalam nama-nama ini menjadi /, sehingga setiap blob disimpan dalam subfolder.
Terakhir diubah pada 20 November 2026