Chuyển đến nội dung chính

Doctor

Overleaf Toolkit đi kèm một script doctor tiện dụng để hỗ trợ gỡ lỗi. Chạy bin/doctor và script sẽ in ra thông tin về môi trường máy host, cấu hình của bạn và các phụ thuộc mà Toolkit cần. Kết quả này cũng có thể giúp chúng tôi chẩn đoán sự cố cho các bản cài đặt Ayakaleaf Pro của bạn.
Người dùng Overleaf Pro có thể mở issue trên GitHub.Bạn nên đính kèm kết quả đầu ra của script bin/doctor trong tin nhắn của mình.

Tham khảo ý kiến Doctor

Chạy script doctor:
Run doctor
Bạn sẽ thấy kết quả tương tự như ví dụ dưới đây.

Thông tin máy host

Phần Host Information chứa thông tin về máy đang chạy Toolkit (ví dụ: bản phân phối Linux và phiên bản phát hành).

Phụ thuộc

Phần Dependencies liệt kê các công cụ cần thiết để Toolkit hoạt động. Nếu một công cụ có mặt, nó sẽ được liệt kê với status: present kèm thông tin phiên bản. Nếu thiếu, nó sẽ được liệt kê với status: MISSING! và một cảnh báo sẽ được thêm vào cuối kết quả của doctor.
Nếu thiếu bất kỳ phụ thuộc nào, gần như chắc chắn Toolkit sẽ không hoạt động.

Cấu hình

Phần Configuration chứa thông tin về các tệp trong thư mục config/. Đối với config/overleaf.rc, doctor sẽ in ra một số giá trị quan trọng. Các tệp bị thiếu sẽ được liệt kê với status: MISSING! và một cảnh báo sẽ được thêm vào cuối kết quả của doctor.
Ghi chú từ ví dụ trên:
  • OVERLEAF_DATA_PATH được đặt là /tmp/overleaf có thể không phải là vị trí an toàn cho dữ liệu quan trọng.
  • MONGO_ENABLED: false nghĩa là Toolkit sẽ không tự cấp phát MongoDB; hãy đảm bảo MONGO_URL trỏ đến một MongoDB được quản lý bên ngoài nếu cần.
  • config/variables.env bị thiếu trong ví dụ.

Cảnh báo

Phần Warnings tóm tắt các vấn đề được script doctor phát hiện. Nếu không có vấn đề nào, phần này sẽ cho biết điều đó.

Hỏi & Đáp

Trả lời: Không, cả ba đều chỉ mang tính thông tin. bin/doctor chỉ in ra một báo cáo, nó không ngăn bin/up chạy.
  • logged in to quay.io: false và cảnh báo Server Pro enabled, but not logged in to quay.io repository: kiểm tra này đến từ Toolkit chính thức, nơi image Server Pro nằm trên một registry quay.io riêng tư. Với SERVER_PRO=true, Toolkit kéo ghcr.io/ayaka-notes/overleaf-pro, vốn là image công khai, nên không cần đăng nhập. Hãy bỏ qua cảnh báo này.
  • grep: /root/.docker/config.json: No such file or directory (hoặc một thư mục home khác): kiểm tra quay.io tìm quay.io trong tệp đó. Docker chỉ ghi tệp này khi có thiết lập cần lưu, ví dụ sau khi chạy docker login, vì vậy nó không tồn tại trên nhiều máy chủ. Tệp này không cần thiết.
  • perl: warning: Setting locale failed: Toolkit chỉ dùng perl ở đây, trong bin/doctor, để in ra phiên bản của nó, và Perl sẽ cảnh báo khi LANG hoặc LC_ALL chỉ định một locale chưa được cài đặt trên máy chủ. Phiên bản vẫn được in ra. Để tắt cảnh báo, hãy đặt các biến này thành một locale có trong danh sách của locale -a, ví dụ C.UTF-8.
Các cảnh báo như Docker daemon is not running, docker not found, Docker Compose not found hoặc thiếu một tệp trong config/ thì cần được khắc phục: Toolkit không thể khởi động nếu thiếu chúng.
Lần sửa đổi cuối 2 tháng 11, 2026