Chuyển đến nội dung chính
Biên dịch trong sandbox hoạt động hơi khác trong môi trường phát triển so với image sản xuất. Môi trường phát triển đã thiết lập sẵn; trang này giải thích các cài đặt và ba điều cần lưu ý:
  • Vấn đề quyền truy cập tệp
  • Chia sẻ volume giữa history-v1 và filestore
  • Vấn đề thư mục con

Bật Sandbox Compiles

Biên dịch trong sandbox được bật theo mặc định. develop/docker-compose.yml đặt SANDBOXED_COMPILES=true cho clsi, còn develop/dev.env chứa phần còn lại:
develop/dev.env
clsi không tự kéo image, vì vậy hãy kéo các image một lần bằng docker pull ghcr.io/ayaka-notes/texlive-full:2026.1 (và :2025.1). LaTeX chạy trong các container anh em dưới người dùng TEXLIVE_IMAGE_USER. Trong môi trường phát triển, đó là tex, cũng là giá trị mặc định của clsi (services/clsi/config/settings.defaults.cjs:154). Image sản xuất dùng www-data thay thế khi SANDBOXED_COMPILES_SIBLING_CONTAINERS=true (server-ce/config/env.sh:15-21), vì ở đó các tệp được tạo bởi người dùng www-data của container Overleaf.
Vui lòng không dùng image do bạn tự build, bạn có thể gặp phải hàng loạt lỗi.

Sửa quyền truy cập tệp

Container clsi khởi động dưới quyền root, giao các thư mục compiles, output và cache cho người dùng node (uid 1000) rồi chạy clsi dưới node (services/clsi/entrypoint.sh). Vì vậy develop/compiles trên máy chủ thuộc về uid 1000, cùng uid với tex trong môi trường phát triển (xem chú thích trong develop/pandoc/Dockerfile). Với các cài đặt trên, môi trường phát triển biên dịch mà không cần thay đổi quyền nào. Nếu bạn đặt TEXLIVE_IMAGE_USER=root thay vào đó, root (uid 0) không có quyền ghi vào các thư mục con của compiles. Khi đó, hãy cấp cho nhóm root quyền sở hữu và quyền ghi trên compiles, đồng thời đặt setgid để các thư mục con mới kế thừa quyền sở hữu này:
bash
Để xem tài liệu chi tiết, bạn có thể tham khảo services/clsi/README.md.

Chia sẻ volume giữa history-v1 và filestore

Các cài đặt trong phần này và phần tiếp theo đã có sẵn trong develop/docker-compose.yml và develop/dev.env. Chúng chỉ có tác dụng khi S3_ENABLED=false trong develop/dev.rc. Với giá trị mặc định S3_ENABLED=true, filestore và history-v1 lưu các tệp này trong bucket RustFS (develop/s3/docker-compose.yml).
Theo mặc định, filestore đóng vai trò cầu nối giữa s3 và các dịch vụ khác trong Overleaf. Tuy nhiên, trong Overleaf CE hoặc Server Pro, tất cả các tệp đều được lưu cục bộ theo mặc định. Vì vậy, Overleaf đã đưa ra một phương pháp khá “mẹo”.
server-ce/config/settings.js
Đồng thời, data/history cũng được dịch vụ lịch sử sử dụng. Bằng cách này, các microservice khác nhau có thể chia sẻ cùng dữ liệu. Đó là lý do dịch vụ filestore trong develop gắn volume history-v1-buckets của history-v1. Nếu không có nó, clsi sẽ không thể lấy tệp blob từ dịch vụ filestore.
develop/docker-compose.yml
filestore tìm các bucket thông qua các cài đặt sau trong dev.env:
develop/dev.env

Sử dụng thư mục con

filestore luôn đọc các blob lịch sử với thư mục con (services/filestore/app/js/KeyBuilder.js:58, :70). Image sản xuất bật useSubdirectories cho history-v1 (server-ce/config/production.json), nhưng cấu hình mặc định của history-v1 thì không, nên khi phát triển history-v1 sẽ làm phẳng toàn bộ dữ liệu. Vì vậy dev.env đặt NODE_CONFIG cho history-v1:
develop/dev.env
Nếu không có nó, history-v1 lưu các tệp project_blobs như sau:
Khi useSubdirectories được đặt thành true, ký tự _ trong các tên này trở thành /, nên mỗi blob được lưu trong các thư mục con.
Lần sửa đổi cuối 20 tháng 11, 2026