- 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
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.
Sửa quyền truy cập tệp
Container clsi khởi động dưới quyền root, giao các thư mụccompiles, 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
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).server-ce/config/settings.js
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
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
project_blobs như sau:
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.
