Chuyển đến nội dung chính
Các dịch vụ tùy chọn này không bắt buộc để chạy Overleaf, nhưng chúng giúp ích rất nhiều khi phát triển, gỡ lỗi và xem xét dữ liệu. Tất cả đều là một phần của môi trường phát triển, nên không cần thêm gì vào docker-compose.yml. Sau khi bạn đăng nhập vào trang web, menu Dev tools trên thanh điều hướng sẽ liên kết tới các công cụ mà trang web phục vụ trên đường dẫn riêng của nó.
Không công cụ nào trong số này có đăng nhập: người dùng ẩn danh của Grafana là quản trị viên của nó, và Mongo Express có thể thay đổi bất kỳ tài liệu nào. Trang web, Hoppscotch, Mongo Express (8081) và RedisInsight (5540) chỉ lắng nghe trên 127.0.0.1 của máy chủ, nên các máy khác không thể truy cập.

Grafana

Grafana được trang web phục vụ tại /grafana/ thông qua webpack-dev-server, nên không cần cổng riêng. Thư mục Overleaf Develop của nó có các dashboard sau:

All services: trạng thái của mọi dịch vụ, máy chủ và tài nguyên mà mỗi dịch vụ sử dụng

Data flow: một chỉnh sửa trên đường từ document-updater qua project-history tới history-v1 và Mongo

Prometheus thu thập /metrics của các dịch vụ, mongodb-exporter, redis-exporter, cadvisor và node-exporter; Alloy gửi nhật ký của mọi container trong dự án tới Loki, nơi các bộ lọc Log search, Service và Log level của dashboard đọc chúng. Dữ liệu của chúng chỉ nằm trong container, nên tạo lại container sẽ xóa sạch. cAdvisor chạy ở chế độ đặc quyền và đọc /, /sys, dữ liệu Docker và socket containerd của máy chủ ở chế độ chỉ đọc; node-exporter đọc / của máy chủ. Các dashboard được tạo tự động: hãy sửa develop/grafana/make-dashboards và chạy nó, thay vì chỉnh sửa các tệp JSON.

Mailpit

Với MAILPIT_ENABLED=true, web gửi mọi email tới Mailpit thay vì một máy chủ thư thật, và xác nhận email được bật (EMAIL_CONFIRMATION_DISABLED=false). Khi đó bạn có thể mở các liên kết kích hoạt, lời mời dự án, đặt lại mật khẩu và mã xác nhận từ hộp thư.

Một email kích hoạt, một lời mời dự án, một mã xác nhận và một lần đặt lại mật khẩu trong Mailpit

Mailpit không có volume: tạo lại container của nó sẽ làm trống hộp thư.

Mongo Express

Mongo Express hiển thị các collection của cơ sở dữ liệu sharelatex, và có thể xem, sửa, nhập và xuất tài liệu của chúng.

Các collection của cơ sở dữ liệu sharelatex trong Mongo Express

RedisInsight

RedisInsight lưu các kết nối của nó trong develop/data/redis-insight. Lần đầu, hãy chọn Connect existing database và nhập host redis và cổng 6379.

RedisInsight đã kết nối tới dịch vụ redis

Thiết lập Hoppscotch

Proxy cho yêu cầu API

Hoppscotch gửi yêu cầu từ trình duyệt, vốn không thể truy cập các dịch vụ bằng tên Docker của chúng. Proxy của nó, Proxyscotch, chạy bên trong mạng Docker và được phục vụ tại /proxy của địa chỉ Hoppscotch. Mở http://localhost:9170, vào Settings → Interceptor, chọn Proxy và đặt Proxy URL thành http://localhost:9170/proxy. Cài đặt được lưu trong trình duyệt.

Cài đặt Interceptor. Ảnh chụp màn hình từ một thiết lập cũ: hãy dùng http://localhost:9170/proxy làm Proxy URL.

Bây giờ bạn có thể thử với http://web:3000/status để kiểm tra xem web có đang hoạt động hay không:

Nhập API của các dịch vụ

develop/hoppscotch/openapi/ có một tệp OpenAPI cho API nội bộ của mỗi dịch vụ. Trong Hoppscotch, mở Collections → Import → Import from File và chọn tất cả các tệp cùng lúc. Mỗi tệp trở thành một collection có các yêu cầu gửi tới địa chỉ Docker của dịch vụ. Các tệp tương tự được hiển thị trong phần API dịch vụ.

Vấn đề CSRF

Nếu bạn dùng Postman hoặc các công cụ gỡ lỗi khác để tạo một yêu cầu post, bạn có thể thấy việc đăng nhập bị từ chối (forbidden), với lỗi 403. Đó là vì Overleaf được bảo vệ bằng cơ chế xác minh csrf.
Trong console, bạn có thể thấy:
Để xử lý vấn đề này khi phát triển Overleaf, bạn cần thiết lập csrf token. Dưới đây là hướng dẫn chi tiết.
1

Thêm Pre Request

Thêm đoạn mã sau vào Pre-Request
Script như sau:
2

Thêm Request Header

Bạn cần thêm các header sau:
3

Đăng nhập bằng công cụ API

Bây giờ bạn có thể đăng nhập bằng tên người dùng và mật khẩu của mình.
Đây là phản hồi khi bạn nhập sai tên người dùng hoặc mật khẩu.
Lần sửa đổi cuối 20 tháng 11, 2026