5. Cá nhân hóa phiên bản của bạn

Đặt cổng, URL trang web và TeX Live image, bật sandboxed compiles và khởi động Ayakaleaf Pro trên WSL 2.

Chạy các lệnh và chỉnh sửa tệp trong Ubuntu, từ ~/ayakaleaf-toolkit.

1. Thiết lập container

   Chỉnh sửa các mục hiện có trong config/overleaf.rc:

   config/overleaf.rc

   PROJECT_NAME=ayakaleaf-wsl
   SERVER_PRO=true
   OVERLEAF_LISTEN_IP=127.0.0.1
   OVERLEAF_PORT=8080
   SIBLING_CONTAINERS_ENABLED=true
   DOCKER_SOCKET_PATH=/var/run/docker.sock
   

   Hãy giữ các đường dẫn dữ liệu mặc định và các dịch vụ MongoDB và Redis đi kèm. Cổng 8080 dành cho trình duyệt cục bộ trên Windows; việc bind vào 127.0.0.1 giữ nó chỉ truy cập được cục bộ. Sandboxed compiles sử dụng một container Linux riêng cho mỗi lần biên dịch, thay vì chạy TeX bên trong container ứng dụng. Docker socket cho phép ứng dụng tạo các container đó, và Toolkit cung cấp đường dẫn trên máy chủ host cho dữ liệu biên dịch trong data/overleaf/data/compiles.

2. Thiết lập ứng dụng

   Trong config/variables.env, đặt các giá trị sau, thay thế mọi mục đang hoạt động có cùng tên:

   config/variables.env

   OVERLEAF_SITE_URL=http://localhost:8080
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026"
   

   Image full bao gồm các gói và phông chữ cần thiết cho nhiều loại dự án. Hãy dành ít nhất 40 GB dung lượng trống cho nó và ứng dụng, cộng thêm dung lượng cho dữ liệu dự án và các bản cập nhật sau này.

   Để thử nghiệm triển khai nhanh, hãy dùng image basic nhỏ hơn. Nó đủ cho bài kiểm tra bài viết đơn giản ở bước 6, nhưng không bao gồm toàn bộ bộ gói và phông chữ:

   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-basic:2026.1
   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-basic:2026.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026 Basic"
   

   Hãy chọn một trong hai bộ này, không để các khóa đang hoạt động bị trùng lặp. Dockerfile của image basic bao gồm latexmk, XeTeX và fontspec, nhưng không có ctex hay bộ sưu tập phông chữ đầy đủ. Việc thiếu một gói LaTeX trong image basic tự nó không cho thấy có vấn đề với sandbox.

   Tạo một session secret:

   openssl rand -hex 32
   

   Thêm kết quả dưới dạng OVERLEAF_SESSION_SECRET trong config/variables.env. Hãy giữ cả invite-token secret đã được tạo. Đối với một phiên bản cục bộ không dùng email, hãy để trống các thiết lập SMTP và OVERLEAF_EMAIL_FROM_ADDRESS.

3. Khởi động phiên bản của bạn

   bin/up -d
   

   Toolkit khởi động MongoDB, khởi tạo replica set của nó, tải xuống TeX Live image đã chọn, rồi khởi động Redis và ứng dụng. Nó có thể trông như đang tạm dừng trong khi một image lớn đang được tải xuống. Không chạy bin/up lần thứ hai khi lần đầu vẫn đang hoạt động.

   Trong một terminal Ubuntu khác, hãy kiểm tra:

   cd "$HOME/ayakaleaf-toolkit"
   bin/docker-compose ps
   bin/docker-compose logs --tail=100 mongo
   bin/docker-compose logs --tail=100 -f sharelatex
   

   Nhấn Ctrl+C để ngừng theo dõi log; các container chạy ở chế độ detached vẫn tiếp tục chạy. Nếu quá trình khởi động thất bại ở MongoDB, hãy làm theo MongoDB không khởi động được trước khi thử lại. Không xóa thư mục dữ liệu của nó để đặt lại một bản cài đặt hiện có.

   Kiểm tra cổng và trang chạy lần đầu:

   bin/docker-compose port sharelatex 80
   curl -I http://localhost:8080/launchpad
   

   Cổng phải là 127.0.0.1:8080. Hãy đợi ứng dụng khởi tạo xong nếu yêu cầu HTTP ban đầu thất bại.

4. Mở phiên bản từ Windows

   Trong trình duyệt trên Windows, mở http://localhost:8080/launchpad. Hãy dùng địa chỉ này cả trên Windows, thay vì một địa chỉ IP WSL tạm thời.

   Để kiểm tra quyền truy cập HTTP từ Windows tách biệt với trình duyệt, hãy chạy trong PowerShell:

   curl.exe -I http://localhost:8080/launchpad
   

   Nếu Ubuntu truy cập được trang nhưng Windows thì không, xem Windows không mở được localhost.

​

Bước tiếp theo

Tiếp tục với 6. Các tác vụ sau cài đặt để tạo quản trị viên và xác minh sandboxed compiles cũng như tính bền vững của dữ liệu.