6. Các tác vụ sau cài đặt

Tạo quản trị viên, xác minh sandboxed compiles và tính bền vững của dữ liệu, và giữ Ayakaleaf Pro luôn chạy trên Windows.

​

Tạo quản trị viên và dự án đầu tiên

Mở http://localhost:8080/launchpad trong trình duyệt trên Windows, tạo tài khoản quản trị viên đầu tiên và đăng nhập. Sau đó làm theo 6. Các tác vụ sau cài đặt của hướng dẫn cho Linux, sử dụng cổng 8080 trong các URL ví dụ của nó.

​

Xác minh việc biên dịch

Một trang đăng nhập hoạt động không chứng minh rằng các container trình biên dịch riêng biệt có thể truy cập thư mục dữ liệu WSL. Hãy tạo một dự án trống và biên dịch tệp main.tex này bằng pdfLaTeX:

\documentclass{article}
\begin{document}
Ayakaleaf Pro on Windows WSL 2.
\end{document}

Bản xem trước PDF phải hiển thị văn bản. Đối với image basic, hãy chọn TeX Live 2026 Basic trong thiết lập dự án nếu cần.

Chọn XeLaTeX và kiểm tra:

\documentclass{article}
\usepackage{fontspec}
\begin{document}
Ayakaleaf WSL XeLaTeX sandbox.
\end{document}

Cả hai ví dụ đều hoạt động với image basic. Đối với tài liệu tiếng Trung, hãy dùng một image có chứa ctex và các phông chữ cần thiết, chẳng hạn như image full, trước khi kiểm tra đoạn sau với XeLaTeX. Image basic không bao gồm chúng:

\documentclass{ctexart}
\begin{document}
你好，Ayakaleaf Pro。
\end{document}

Để xác nhận sandbox đang được sử dụng, hãy chạy trong Ubuntu trong khi biên dịch:

docker ps -a --filter ancestor=ghcr.io/ayaka-notes/texlive-basic:2026.1
bin/logs -f clsi

Hãy dùng tên image bạn đã chọn trong bộ lọc. Các lần biên dịch ngắn có thể hoàn tất trước khi docker ps chạy; -a cũng hiển thị các container đã dừng cho đến khi được dọn dẹp. Một container trình biên dịch phải dùng image đó và một bind mount /compile từ thư mục dữ liệu WSL của Toolkit. Chỉ riêng log của ứng dụng không thể thay thế cho việc kiểm tra PDF.

​

Xác minh tính bền vững của dữ liệu

Trong Ubuntu, từ thư mục Toolkit:

bin/stop
bin/start

Đợi ứng dụng khởi động, mở lại dự án từ Windows và biên dịch lại. Tài khoản, mã nguồn và các tệp dự án của bạn vẫn phải còn đó. Dữ liệu đang hoạt động mặc định nằm trong ~/ayakaleaf-toolkit/data/ bên trong Ubuntu. Hãy giữ cả config/ và data/; việc gỡ cài đặt hoặc hủy đăng ký bản phân phối Ubuntu có thể xóa chúng.

​

Giữ cho phiên bản luôn khả dụng

Có ba yếu tố để giữ phiên bản luôn chạy: Windows luôn thức, Docker Desktop đang chạy, và các container khởi động lại cùng với engine.

Trong Settings → General của Docker Desktop, bật Start Docker Desktop when you sign in to your computer, xem Thiết lập Docker Desktop. Thiết lập này khởi động Docker sau khi đăng nhập, không phải trước khi đăng nhập. Sau khi Windows khởi động lại, hãy đăng nhập, đợi Docker Desktop khởi động xong, mở Ubuntu và kiểm tra docker ps cũng như trang web.

Resource Saver của Docker Desktop tách biệt với chế độ ngủ của Windows. Nó thường chỉ kích hoạt khi không có container nào đang chạy; ứng dụng, MongoDB và Redis đang chạy sẽ ngăn điều kiện nhàn rỗi đó. Trên WSL 2, nó tạm dừng Docker engine thay vì tắt máy ảo WSL dùng chung. Không Pause Docker Desktop thủ công trong khi đang phục vụ người dùng. Bạn không cần tắt Resource Saver chỉ để giữ stack này chạy; xem tài liệu Resource Saver của Docker.

Các dịch vụ của Toolkit sử dụng restart: always. Hãy xác minh thiết lập thực tế trong Ubuntu:

docker inspect sharelatex mongo redis --format '{{.Name}} restart={{.HostConfig.RestartPolicy.Name}}'

Mỗi dịch vụ phải báo always. Khi Docker chạy, nó có thể khởi động lại các container hiện có đó mà không cần bin/up mới. Một container bị dừng thủ công sẽ vẫn dừng cho đến khi bạn khởi động nó hoặc khởi động lại engine; với always, việc khởi động lại engine có thể khởi động lại nó. Xem hành vi của restart policy trong Docker.

Hành động	Ảnh hưởng đến Ayakaleaf
Đóng terminal Ubuntu sau khi chạy bin/up -d	Các container chạy ở chế độ detached; terminal không phải là tiến trình giám sát chúng. Hãy giữ Docker Desktop và môi trường WSL luôn khả dụng
Đóng cửa sổ Docker Dashboard	Cửa sổ có thể đóng trong khi Docker Desktop tiếp tục chạy trong khay hệ thống
Chọn Quit Docker Desktop	Dừng engine và khiến trang web không khả dụng; mở lại Docker Desktop để khôi phục
Chạy wsl --shutdown	Dừng tất cả các bản phân phối WSL và làm gián đoạn backend WSL của Docker; khởi động lại Docker Desktop và mở lại Ubuntu
Cho Windows ngủ, ngủ đông hoặc tắt máy	Dịch vụ không khả dụng; chỉ giữ màn hình bật hoặc tắt không thay đổi điều này
Chạy bin/stop	Dừng phiên bản nhưng vẫn giữ dữ liệu của nó; dùng bin/start để tiếp tục

Để sử dụng lâu dài khi cắm nguồn AC, hãy mở Settings → System → Power & battery → Screen, sleep & hibernate timeouts của Windows 11 (một số phiên bản hiển thị Power hoặc Screen and sleep). Đặt thời gian chờ ngủ khi cắm nguồn thành Never và tắt chế độ ngủ đông tự động nếu đã được cấu hình. Màn hình vẫn có thể tắt. Hành động khi gập nắp laptop là một thiết lập riêng; gập nắp có thể khiến máy chuyển sang chế độ ngủ ngay cả khi thời gian chờ ngủ khi nhàn rỗi là Never. Xem thiết lập nguồn của Windows.

Không chạy wsl --shutdown như một thao tác dọn dẹp thường xuyên khi trang web đang được sử dụng. Nếu một thay đổi thiết lập WSL cần đến nó, hãy dừng phiên bản trước và lên kế hoạch cho khoảng thời gian gián đoạn. Windows có thể chạy phiên bản liên tục với các thiết lập này. Đối với một dịch vụ dùng chung phải tiếp tục hoạt động qua các lần đăng xuất và khởi động lại không có người giám sát, chúng tôi khuyến nghị hướng dẫn cho Linux.

​

Kiểm tra khả năng khôi phục sau khi khởi động lại Docker Desktop

Sau khi lưu công việc và để các lần biên dịch đang chạy hoàn tất, hãy chọn Restart Docker Desktop từ menu khắc phục sự cố của Docker Desktop. Đợi engine khởi động, sau đó kiểm tra trong Ubuntu:

docker ps
curl -I http://localhost:8080/launchpad

Mở dự án hiện có trên Windows và biên dịch lại. Xác nhận rằng tài khoản và mã nguồn vẫn còn tồn tại.

Nếu bạn đã chủ động dừng phiên bản bằng bin/stop, hãy dùng bin/start. Nếu Docker đang chạy nhưng một dịch vụ bị lỗi, hãy đọc log của nó thay vì tạo lại cấu hình. Windows Update, các bản cập nhật Docker và mất điện vẫn có thể làm gián đoạn một bản cài đặt chạy 24 giờ; hãy giữ các bản sao lưu và kiểm tra khả năng khôi phục sau các đợt bảo trì theo kế hoạch.

​

Sử dụng hằng ngày

Khởi động Docker Desktop trong Windows. Mở Ubuntu:

cd "$HOME/ayakaleaf-toolkit"

Tác vụ	Lệnh
Khởi động các container hiện có	bin/start
Dừng các container và giữ dữ liệu	bin/stop
Áp dụng các thay đổi cấu hình	bin/up -d
Kiểm tra trạng thái	bin/docker-compose ps
Đọc log khởi động	bin/docker-compose logs --tail=100 sharelatex
Đọc log của MongoDB	bin/docker-compose logs --tail=100 mongo
Đọc log của trình biên dịch	bin/logs -f clsi

bin/start không áp dụng các chỉnh sửa cấu hình: hãy dùng bin/up -d sau khi thay đổi config/. Hãy làm theo Dữ liệu và sao lưu trước khi nâng cấp, di chuyển hoặc gỡ bỏ bản phân phối WSL. Sao chép các tệp MongoDB đang hoạt động trong khi cơ sở dữ liệu đang ghi không phải là một bản sao lưu nhất quán.

Hãy giữ 127.0.0.1 khi dùng cục bộ. Để phục vụ các máy tính khác, bạn cũng cần chủ động thiết lập địa chỉ lắng nghe, URL trang web, cấu hình tường lửa/mạng của Windows và HTTPS; chỉ thay đổi OVERLEAF_SITE_URL không publish một cổng.

Nếu có gì đó không hoạt động, hãy xem Khắc phục sự cố.