Перейти к основному содержанию

Doctor

Overleaf Toolkit включает удобный скрипт doctor, помогающий при отладке. Запустите bin/doctor, и скрипт выведет сведения о хост-окружении, вашей конфигурации и зависимостях, необходимых Toolkit. Этот вывод также поможет нам диагностировать проблемы в ваших установках Ayakaleaf Pro.
Пользователи Overleaf Pro могут создать issue на GitHub.Рекомендуем приложить к сообщению вывод скрипта bin/doctor.

Консультация с Doctor

Запустите скрипт doctor:
Run doctor
Вы увидите вывод, похожий на пример ниже.

Информация о хосте

Раздел Host Information содержит сведения о машине, на которой работает Toolkit (например, дистрибутив Linux и его выпуск).

Зависимости

В разделе Dependencies перечислены инструменты, необходимые для работы Toolkit. Если инструмент установлен, он будет отмечен как status: present с информацией о версии. Если он отсутствует, он будет отмечен как status: MISSING!, а в конец вывода doctor будет добавлено предупреждение.
Если какие-либо зависимости отсутствуют, Toolkit почти наверняка не будет работать.

Конфигурация

Раздел Configuration содержит сведения о файлах в каталоге config/. Для config/overleaf.rc doctor выводит некоторые ключевые значения. Отсутствующие файлы будут отмечены как status: MISSING!, а в конец вывода doctor будет добавлено предупреждение.
Замечания к приведённому примеру:
  • OVERLEAF_DATA_PATH, равный /tmp/overleaf, может быть небезопасным местом для хранения важных данных.
  • MONGO_ENABLED: false означает, что Toolkit не будет разворачивать собственную MongoDB; при необходимости убедитесь, что MONGO_URL указывает на внешнюю MongoDB.
  • В этом примере отсутствует config/variables.env.

Предупреждения

Раздел Warnings содержит сводку проблем, обнаруженных скриптом doctor. Если проблем нет, это будет указано в данном разделе.

Вопросы и ответы

Ответ: Нет, все три носят информационный характер. bin/doctor только выводит отчёт и не останавливает bin/up.
  • logged in to quay.io: false и предупреждение Server Pro enabled, but not logged in to quay.io repository: эта проверка унаследована от официального Toolkit, где образ Server Pro находится в закрытом реестре quay.io. При SERVER_PRO=true Toolkit загружает ghcr.io/ayaka-notes/overleaf-pro, который является публичным, поэтому вход не требуется. Игнорируйте это предупреждение.
  • grep: /root/.docker/config.json: No such file or directory (или другой домашний каталог): проверка quay.io ищет quay.io в этом файле. Docker создаёт его только тогда, когда нужно сохранить какие-либо настройки, например после docker login, поэтому на многих серверах он отсутствует. Он не нужен.
  • perl: warning: Setting locale failed: Toolkit использует perl только здесь, в bin/doctor, чтобы вывести его версию, а Perl выдаёт предупреждение, когда LANG или LC_ALL указывает на локаль, не установленную на хосте. Версия всё равно выводится. Чтобы убрать предупреждение, задайте этим переменным локаль из списка locale -a, например C.UTF-8.
Предупреждения вроде Docker daemon is not running, docker not found, Docker Compose not found или об отсутствующем файле в config/ исправлять нужно: без этого Toolkit не сможет запуститься.
Последнее изменение 2 ноября 2026 г.