Przejdź do głównej treści

Doctor

Overleaf Toolkit zawiera przydatny skrypt doctor, który ułatwia debugowanie. Uruchom bin/doctor, a skrypt wyświetli informacje o środowisku hosta, Twojej konfiguracji oraz zależnościach wymaganych przez Toolkit. Te dane wyjściowe mogą również pomóc nam w diagnozowaniu problemów z Twoimi instalacjami Ayakaleaf Pro.
Użytkownicy Overleaf Pro mogą zgłosić problem na GitHub.Warto dołączyć do zgłoszenia wynik działania skryptu bin/doctor.

Konsultacja z Doctorem

Uruchom skrypt doctor:
Run doctor
Zobaczysz dane wyjściowe podobne do poniższego przykładu.

Informacje o hoście

Sekcja Host Information zawiera informacje o maszynie, na której działa Toolkit (na przykład dystrybucję i wydanie systemu Linux).

Zależności

Sekcja Dependencies zawiera listę narzędzi wymaganych do działania Toolkit. Jeśli narzędzie jest obecne, zostanie oznaczone jako status: present wraz z informacją o wersji. Jeśli go brakuje, zostanie oznaczone jako status: MISSING!, a na końcu danych wyjściowych doctor pojawi się ostrzeżenie.
Jeśli brakuje którejkolwiek zależności, Toolkit niemal na pewno nie będzie działać.

Konfiguracja

Sekcja Configuration zawiera informacje o plikach w katalogu config/. W przypadku config/overleaf.rc doctor wyświetla niektóre kluczowe wartości. Brakujące pliki zostaną oznaczone jako status: MISSING!, a na końcu danych wyjściowych doctor pojawi się ostrzeżenie.
Uwagi do powyższego przykładu:
  • OVERLEAF_DATA_PATH ustawione na /tmp/overleaf może nie być bezpieczną lokalizacją dla ważnych danych.
  • MONGO_ENABLED: false oznacza, że Toolkit nie utworzy własnej instancji MongoDB; w razie potrzeby upewnij się, że MONGO_URL wskazuje na zewnętrznie zarządzaną bazę MongoDB.
  • W przykładzie brakuje pliku config/variables.env.

Ostrzeżenia

Sekcja Warnings podsumowuje problemy wykryte przez skrypt doctor. Jeśli nie ma żadnych problemów, sekcja to zasygnalizuje.

Pytania i odpowiedzi

Odpowiedź: Nie, wszystkie trzy mają charakter informacyjny. bin/doctor jedynie wyświetla raport i nie zatrzymuje bin/up.
  • logged in to quay.io: false oraz ostrzeżenie Server Pro enabled, but not logged in to quay.io repository: to sprawdzenie pochodzi z oficjalnego Toolkit, w którym obraz Server Pro znajduje się w prywatnym rejestrze quay.io. Przy SERVER_PRO=true Toolkit pobiera obraz ghcr.io/ayaka-notes/overleaf-pro, który jest publiczny, więc logowanie nie jest potrzebne. Zignoruj to ostrzeżenie.
  • grep: /root/.docker/config.json: No such file or directory (lub inny katalog domowy): sprawdzenie quay.io szuka quay.io w tym pliku. Docker zapisuje go tylko wtedy, gdy ma ustawienia do zapisania, na przykład po docker login, więc na wielu serwerach go brakuje. Nie jest on potrzebny.
  • perl: warning: Setting locale failed: Toolkit używa perl tylko tutaj, w bin/doctor, aby wyświetlić jego wersję, a Perl ostrzega, gdy LANG lub LC_ALL wskazuje ustawienia regionalne, które nie są zainstalowane na hoście. Wersja i tak zostaje wyświetlona. Aby wyciszyć ostrzeżenie, ustaw te zmienne na ustawienia regionalne wymienione przez locale -a, na przykład C.UTF-8.
Ostrzeżenia takie jak Docker daemon is not running, docker not found, Docker Compose not found lub brakujący plik w config/ wymagają naprawy: bez tego Toolkit nie może się uruchomić.
Ostatnia modyfikacja 2 listopada 2026