> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/vi/cau-hinh/overleaf-toolkit/files-and-locations.md).

# Tệp và vị trí

Trang này mô tả các tệp cấu hình được Toolkit sử dụng để cấu hình việc triển khai Overleaf tại chỗ của bạn.

### Dữ liệu bền vững

Overleaf Toolkit cần lưu trữ dữ liệu bền vững, chẳng hạn như các tệp cần thiết để biên dịch các dự án LaTeX, và nội dung của cơ sở dữ liệu MongoDB. Việc này được thực hiện bằng cách gắn một vài thư mục từ máy chủ vào các vùng chứa Docker, rồi ghi dữ liệu vào các thư mục đó.

#### Thư mục dữ liệu

Trường `sharelatex` vùng chứa cần một thư mục để lưu trữ dữ liệu liên quan đến các lần biên dịch LaTeX. Thư mục này được đặt bằng `OVERLEAF_DATA_PATH` biến trong `config/overleaf.rc`.

Trường `mongo` vùng chứa, nếu được bật, cần một thư mục để lưu trữ các tệp cơ sở dữ liệu của nó, và điều tương tự cũng đúng với `redis` vùng chứa. Các thư mục này cũng có thể được cấu hình trong `config/overleaf.rc`.

#### Quyền tệp

Vì Docker chạy với vai trò `root`nên các thư mục dữ liệu cuối cùng sẽ thuộc sở hữu của `root` người dùng, ngay cả khi Toolkit đang được dùng bởi một người dùng không phải root. Điều này không phải là vấn đề, nhưng đáng lưu ý nếu bạn định thay đổi dữ liệu bền vững từ bên ngoài các vùng chứa.

### Vị trí tệp cấu hình

Tất cả các tệp cấu hình thuộc sở hữu người dùng đều nằm trong thư mục `thư mục config/,` .

Thư mục này **bị loại trừ** khỏi hệ thống kiểm soát phiên bản git, vì vậy nó sẽ không bị thay đổi khi cập nhật mã Toolkit. Toolkit sẽ **không** thay đổi bất kỳ dữ liệu nào trong `thư mục config/,` thư mục mà không có sự cho phép của bạn.

{% hint style="info" %}
Các thay đổi đối với các tệp cấu hình sẽ không được tự động áp dụng cho các vùng chứa hiện có, ngay cả khi vùng chứa bị dừng và khởi động lại (bằng `bin/stop` và `bin/start`). Để áp dụng các thay đổi, hãy chạy `bin/up`, và ở phía sau, `docker compose` sẽ tự động áp dụng các thay đổi cấu hình cho một vùng chứa mới. (Hoặc, hãy chạy `bin/up -d`nếu bạn không muốn gắn vào nhật ký Docker.)
{% endhint %}

### Trường `overleaf.rc` tệp

Trường `config/overleaf.rc` tệp chứa các thiết lập cấu hình cấp cao nhất quan trọng nhất được Toolkit sử dụng. Nó chứa các câu lệnh đặt biến, theo định dạng: `VARIABLE_NAME=value`

Để xem phân tích chi tiết của tất cả các tùy chọn cấu hình có sẵn, hãy xem phần cài đặt của chúng tôi.

### Trường `variables.env` tệp

Trường `config/variables.env` tệp chứa các biến môi trường được nạp vào `sharelatex` vùng chứa, và được dùng để cấu hình các microservice của Overleaf. Chúng bao gồm tên của ứng dụng, được hiển thị trong phần đầu của giao diện web, các cài đặt để gửi email, và các cài đặt cao cấp khác như SSO để dùng với Server Pro.

Để xem phân tích chi tiết của tất cả các biến môi trường có sẵn, hãy xem [Các biến môi trường](broken://pages/556eaeb4dddcb30f8e61eab36f50573c660f1752) phần.

### Trường `phiên bản` tệp

Trường `config/version` tệp chứa số phiên bản của ảnh Docker sẽ được dùng để tạo phiên bản đang chạy của máy chủ Overleaf của bạn.

{% hint style="info" %}
Các thay đổi đối với các tệp cấu hình này sẽ không được tự động áp dụng cho các vùng chứa hiện có, ngay cả khi vùng chứa bị dừng và khởi động lại (bằng `bin/stop` và `bin/start`). Để áp dụng các thay đổi của bạn, hãy chạy `bin/up`, và Toolkit sẽ tự động tạo cho bạn một vùng chứa mới với các thay đổi cấu hình đã được áp dụng.
{% endhint %}

### Trường `docker-compose.override.yml` tệp

Nếu có, `config/docker-compose.override.yml` tệp sẽ được bao gồm trong lời gọi tới `docker compose`. Điều này hữu ích để ghi đè cấu hình dành riêng cho Docker Compose.

Xem [tài liệu Docker Compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) để biết thêm chi tiết.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/vi/cau-hinh/overleaf-toolkit/files-and-locations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.