메인 콘텐츠로 건너뛰기

Doctor

Overleaf Toolkit에는 디버깅에 유용한 doctor 스크립트가 포함되어 있습니다. bin/doctor를 실행하면 호스트 환경, 구성, Toolkit에 필요한 의존성에 대한 정보가 출력됩니다. 이 출력은 Ayakaleaf Pro 설치의 문제를 진단하는 데에도 도움이 됩니다.
Overleaf Pro 사용자는 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 스크립트가 발견한 문제가 요약됩니다. 문제가 없으면 이 섹션에 그 사실이 표시됩니다.

Q&A

답변: 아니요, 세 가지 모두 정보 제공용입니다. bin/doctor는 보고서를 출력할 뿐이며 bin/up을 중단시키지 않습니다.
  • logged in to quay.io: false 및 경고 Server Pro enabled, but not logged in to quay.io repository: 이 검사는 Server Pro 이미지가 비공개 quay.io 레지스트리에 있는 공식 Toolkit에서 비롯된 것입니다. 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은 bin/doctor에서 버전을 출력할 때만 perl을 사용하며, LANG 또는 LC_ALL이 호스트에 설치되지 않은 로캘을 지정하면 Perl이 경고를 표시합니다. 버전은 여전히 출력됩니다. 경고를 없애려면 이 변수들을 locale -a에 나열된 로캘(예: C.UTF-8)로 설정하세요.
Docker daemon is not running, docker not found, Docker Compose not found 또는 config/의 파일 누락과 같은 경고는 반드시 수정해야 합니다. 이것들이 없으면 Toolkit을 시작할 수 없습니다.
마지막 수정일 2026년 11월 2일