Doctor
Overleaf Toolkit đi kèm một scriptdoctor 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
Ví dụ kết quả đầy đủ
Ví dụ kết quả đầy đủ
Thông tin máy host
PhầnHost 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).
Ví dụ kết quả Host Information
Ví dụ kết quả Host Information
Phụ thuộc
PhầnDependencies 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.
Ví dụ kết quả Dependency (có mặt)
Ví dụ kết quả Dependency (có mặt)
Ví dụ kết quả Dependency (bị thiếu)
Ví dụ kết quả Dependency (bị thiếu)
Cấu hình
PhầnConfiguration 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.
Ví dụ kết quả Configuration
Ví dụ kết quả Configuration
OVERLEAF_DATA_PATHđược đặt là/tmp/overleafcó thể không phải là vị trí an toàn cho dữ liệu quan trọng.MONGO_ENABLED: falsenghĩa là Toolkit sẽ không tự cấp phát MongoDB; hãy đảm bảoMONGO_URLtrỏ đến một MongoDB được quản lý bên ngoài nếu cần.config/variables.envbị thiếu trong ví dụ.
Cảnh báo
PhầnWarnings 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 đó.
Ví dụ kết quả Warnings
Ví dụ kết quả Warnings
Hỏi & Đáp
Các thông báo về quay.io, cấu hình Docker và locale Perl từ bin/doctor có cần khắc phục không?
Các thông báo về quay.io, cấu hình Docker và locale Perl từ bin/doctor có cần khắc phục không?
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: falsevà cảnh báoServer 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ớiSERVER_PRO=true, Toolkit kéoghcr.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ìmquay.iotrong tệp đó. Docker chỉ ghi tệp này khi có thiết lập cần lưu, ví dụ sau khi chạydocker 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ùngperlở đây, trongbin/doctor, để in ra phiên bản của nó, và Perl sẽ cảnh báo khiLANGhoặcLC_ALLchỉ đị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ủalocale -a, ví dụC.UTF-8.
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.
