> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/vi/ho-tro/getting-help.md).

# Nhận trợ giúp

### Bác sĩ

Bộ công cụ Overleaf đi kèm một `doctor` script để hỗ trợ gỡ lỗi. Chạy `bin/doctor` và script sẽ in thông tin về môi trường máy chủ của bạn, cấu hình của bạn và các phụ thuộc mà Toolkit cần. Kết quả này cũng có thể giúp đội hỗ trợ Overleaf chẩn đoán sự cố cho các bản cài đặt Server Pro.

{% hint style="info" %}
Người dùng Overleaf Pro có thể [mở một issue trên GitHub](https://github.com/ayaka-notes/overleaf/issues).

nên đưa kèm đầu ra của `bin/doctor` script trong tin nhắn của bạn.
{% endhint %}

### Tham khảo Bác sĩ <a href="#consulting-with-the-doctor" id="consulting-with-the-doctor"></a>

Chạy script doctor:

{% code title="Chạy doctor" %}

```bash
bin/doctor
```

{% endcode %}

Bạn sẽ thấy đầu ra tương tự như ví dụ bên dưới.

<details>

<summary>Đầu ra đầy đủ ví dụ</summary>

```
====== Overleaf Doctor ======
- Thông tin máy chủ
    - Linux
    - Kết quả của 'lsb_release -a':
            Không có mô-đun LSB nào sẵn có.
            Mã nhà phân phối:	Ubuntu
            Mô tả:	Ubuntu 22.04.5 LTS
            Bản phát hành:	22.04
            Tên mã:	jammy
- Phụ thuộc
    - bash
        - trạng thái: có sẵn
        - thông tin phiên bản: 5.1.16(1)-release
    - docker
        - trạng thái: có sẵn
        - thông tin phiên bản: Docker version 28.0.4, build b8034c0
    - docker compose
        - trạng thái: có sẵn
        - thông tin phiên bản: Docker Compose version v2.34.0
    - realpath
        - trạng thái: có sẵn
        - thông tin phiên bản: realpath (GNU coreutils) 8.32
    - perl
        - trạng thái: có sẵn
        - thông tin phiên bản: 5.034000
    - awk
        - trạng thái: có sẵn
        - thông tin phiên bản: mawk 1.3.4 20200120
- Docker Daemon
    - trạng thái: đang chạy
====== Cấu hình ======
- config/version
    - trạng thái: có sẵn
    - phiên bản: 5.4.0
- config/overleaf.rc
    - trạng thái: có sẵn
    - các giá trị
        - OVERLEAF_DATA_PATH: data/overleaf
        - OVERLEAF_LOG_PATH: data/overleaf/logs
        - SERVER_PRO: true
        - SIBLING_CONTAINERS_ENABLED: true
            - đã đăng nhập vào quay.io: true
        - MONGO_ENABLED: true
        - REDIS_ENABLED: true
- config/variables.env
    - trạng thái: có sẵn
    - các giá trị
        - OVERLEAF_FILESTORE_BACKEND: fs
        - OVERLEAF_HISTORY_BACKEND: fs

====== Cảnh báo ======
- Không có, mọi thứ đều ổn
====== Kết thúc ======
```

</details>

### Thông tin máy chủ

Trường `Thông tin máy chủ` phần này chứa thông tin về máy đang chạy Toolkit (ví dụ: bản phân phối Linux và bản phát hành).

<details>

<summary>Ví dụ đầu ra Thông tin máy chủ</summary>

```
- Thông tin máy chủ
    - Linux
    - Kết quả của 'lsb_release -a':
            Không có mô-đun LSB nào sẵn có.
            Mã nhà phân phối:	Ubuntu
            Mô tả:	Ubuntu 22.04.5 LTS
            Bản phát hành:	22.04
            Tên mã:	jammy
```

</details>

### Các phụ thuộc

Trường `Các phụ thuộc` phần này liệt kê các công cụ cần thiết để Toolkit hoạt động. Nếu một công cụ hiện diện, nó sẽ được liệt kê là `trạng thái: có sẵn` kèm thông tin phiên bản. Nếu thiếu, nó sẽ được liệt kê là `trạng thái: THIẾU!` và một cảnh báo sẽ được thêm vào cuối `doctor` đầu ra.

<details>

<summary>Ví dụ đầu ra Phụ thuộc (có sẵn)</summary>

```
- docker
    - trạng thái: có sẵn
    - thông tin phiên bản: Docker version 28.0.4, build b8034c0
```

</details>

<details>

<summary>Ví dụ đầu ra Phụ thuộc (thiếu)</summary>

```
- docker
    - trạng thái: THIẾU!
```

</details>

Nếu thiếu bất kỳ phụ thuộc nào, rất có thể Toolkit sẽ không hoạt động.

### Cấu hình

Trường `Cấu hình` phần này chứa thông tin về các tệp trong `config/` thư mục. Đối với `config/overleaf.rc`, doctor sẽ in ra một số giá trị chính. Các tệp bị thiếu sẽ được liệt kê là `trạng thái: THIẾU!` và một cảnh báo sẽ được thêm vào cuối `doctor` đầu ra.

<details>

<summary>Ví dụ đầu ra Cấu hình</summary>

```
====== Cấu hình ======
- config/version
    - trạng thái: có sẵn
    - phiên bản: 5.4.0
- config/overleaf.rc
    - trạng thái: có sẵn
    - các giá trị
        - OVERLEAF_DATA_PATH: /tmp/overleaf
        - SERVER_PRO: false
        - MONGO_ENABLED: false
        - REDIS_ENABLED: true
- config/variables.env
    - trạng thái: THIẾU!
```

</details>

Ghi chú từ ví dụ ở trên:

* `OVERLEAF_DATA_PATH` được đặt thành `/tmp/overleaf` có thể không phải là vị trí an toàn cho dữ liệu quan trọng.
* `MONGO_ENABLED: false` có nghĩa là Toolkit sẽ không tự cấp phát MongoDB cho riêng nó; hãy đảm bảo `MONGO_URL` trỏ đến một MongoDB được quản lý bên ngoài nếu cần.
* `config/variables.env` bị thiếu trong ví dụ.

### Cảnh báo

Trường `Cảnh báo` phần này tóm tắt các vấn đề được script doctor phát hiện. Nếu không có vấn đề nào, phần này sẽ cho biết điều đó.

<details>

<summary>Ví dụ đầu ra Cảnh báo</summary>

```
====== Cảnh báo ======
- không tìm thấy tệp cấu hình variables.env
- tệp rc, chưa đặt OVERLEAF_DATA_PATH
====== Kết thúc =======
```

</details>


---

# 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://overleaf-pro.ayaka.space/on-premises/vi/ho-tro/getting-help.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.
