메인 콘텐츠로 건너뛰기
이 선택적 서비스는 Overleaf 실행에 필요하지는 않지만 개발, 디버깅, 데이터 확인에 큰 도움이 됩니다. 모두 개발 환경의 일부이므로 docker-compose.yml에 추가할 것은 없습니다. 사이트에 로그인하면 내비게이션 바의 Dev tools 메뉴가 사이트가 자체 경로로 제공하는 도구로 연결됩니다.
이 도구들에는 로그인이 없습니다. Grafana의 익명 사용자는 관리자이며, Mongo Express는 어떤 문서든 변경할 수 있습니다. 사이트, Hoppscotch, Mongo Express(8081), RedisInsight(5540)는 호스트의 127.0.0.1에서만 수신하므로 다른 호스트에서는 접근할 수 없습니다.

Grafana

Grafana는 webpack-dev-server를 통해 사이트의 /grafana/에서 제공되므로 자체 포트가 필요 없습니다. Overleaf Develop 폴더에는 다음 대시보드가 있습니다.

All services: 모든 서비스의 상태, 호스트, 각 서비스가 사용하는 리소스

Data flow: document-updater에서 project-history를 거쳐 history-v1과 Mongo로 가는 편집

Prometheus는 서비스의 /metrics, mongodb-exporter, redis-exporter, cadvisor, node-exporter를 수집하고, Alloy는 프로젝트의 모든 컨테이너 로그를 Loki로 보내며 대시보드의 Log search, Service, Log level 필터가 이를 읽습니다. 이 데이터는 컨테이너 안에만 있으므로 컨테이너를 다시 만들면 비워집니다. cAdvisor는 특권 모드로 실행되며 호스트의 /, /sys, Docker 데이터, containerd 소켓을 읽기 전용으로 읽고, node-exporter는 호스트의 /를 읽습니다. 대시보드는 생성된 것입니다. JSON 파일을 편집하는 대신 develop/grafana/make-dashboards를 수정하고 실행하세요.

Mailpit

MAILPIT_ENABLED=true이면 web은 모든 이메일을 실제 메일 서버 대신 Mailpit으로 보내며, 이메일 확인이 켜집니다(EMAIL_CONFIRMATION_DISABLED=false). 활성화 링크, 프로젝트 초대, 비밀번호 재설정, 확인 코드를 받은편지함에서 따라갈 수 있습니다.

Mailpit의 활성화 이메일, 프로젝트 초대, 확인 코드, 비밀번호 재설정

Mailpit에는 볼륨이 없으므로 컨테이너를 다시 만들면 받은편지함이 비워집니다.

Mongo Express

Mongo Express는 sharelatex 데이터베이스의 컬렉션을 보여 주며, 그 문서를 보고, 편집하고, 가져오고, 내보낼 수 있습니다.

Mongo Express의 sharelatex 데이터베이스 컬렉션

RedisInsight

RedisInsight는 연결 정보를 develop/data/redis-insight에 보관합니다. 처음에는 Connect existing database를 선택하고 호스트 redis, 포트 6379를 입력하세요.

redis 서비스에 연결된 RedisInsight

Hoppscotch 설정

API 요청 프록시

Hoppscotch는 브라우저에서 요청을 보내는데, 브라우저는 Docker 이름으로 서비스에 접근할 수 없습니다. 프록시인 Proxyscotch는 Docker 네트워크 안에서 실행되며 Hoppscotch 주소의 /proxy에서 제공됩니다. http://localhost:9170을 열고 Settings → Interceptor에서 Proxy를 선택한 뒤 Proxy URL을 http://localhost:9170/proxy로 설정하세요. 이 설정은 브라우저에 저장됩니다.

Interceptor 설정. 스크린샷은 이전 구성의 것입니다. Proxy URL로 http://localhost:9170/proxy를 사용하세요.

이제 http://web:3000/status로 테스트하여 web이 살아 있는지 확인할 수 있습니다.

서비스 API 가져오기

develop/hoppscotch/openapi/에는 각 서비스의 내부 API에 대한 OpenAPI 파일이 있습니다. Hoppscotch에서 Collections → Import → Import from File을 열고 모든 파일을 한 번에 선택하세요. 각 파일은 요청이 서비스의 Docker 주소로 가는 컬렉션이 됩니다. 같은 파일이 서비스 API 섹션에 표시됩니다.

CSRF 문제

Postman이나 다른 디버그 도구로 post 요청을 보내면 로그인이 금지되며 403 오류가 발생하는 것을 볼 수 있습니다. 이는 Overleaf가 csrf 검증으로 보호되고 있기 때문입니다.
콘솔에서 다음과 같은 내용을 볼 수 있습니다.
Overleaf 개발 중 이 문제를 해결하려면 csrf 토큰을 설정해야 합니다. 자세한 방법은 다음과 같습니다.
1

Pre-Request 추가

Pre-Request에 다음 코드를 추가합니다.
스크립트는 다음과 같습니다.
2

요청 헤더 추가

다음 헤더를 추가해야 합니다.
3

API 도구로 로그인

이제 사용자 이름과 비밀번호로 로그인할 수 있습니다.
잘못된 사용자 이름이나 비밀번호를 입력했을 때의 응답은 다음과 같습니다.
마지막 수정일 2026년 11월 20일