> 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/cau-hinh/overleaf-toolkit/environment-variables.md). # Biến môi trường Trang này mô tả các biến môi trường được hỗ trợ trong `config/variables.env` tệp dành cho các triển khai Toolkit. Trường `config/variables.env` tệp gồm các định nghĩa biến theo dạng `NAME=value`; các dòng bắt đầu bằng `#` được coi là chú thích. {% hint style="info" %} Bạn cần tạo lại các container Docker sau khi thay đổi bất kỳ điều gì trong `overleaf.rc` hoặc `variables.env` bằng cách chạy `bin/up`. {% endhint %} ### Tất cả các phiên bản Các biến môi trường này tương thích với Server CE và Server Pro, đồng thời cung cấp một lộ trình di chuyển dễ dàng giữa hai phiên bản cài đặt tại chỗ này. Chúng cũng có thể được dùng với cả các triển khai Toolkit và Docker Compose. {% hint style="info" %} Trước đây, các biến môi trường này có tiền tố `SHARELATEX_` thay vì `OVERLEAF_`. {% endhint %} | Tên | Mô tả | | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OVERLEAF_SITE_URL` | Nơi phiên bản Overleaf của bạn có sẵn công khai. Mục này được dùng trong các liên kết công khai và khi kết nối qua websocket, vì vậy phải được cấu hình chính xác! | | `OVERLEAF_ADMIN_EMAIL` | Địa chỉ email để người dùng có thể liên hệ với người phụ trách trang web. | | `OVERLEAF_APP_NAME` | Tên hiển thị khi nói về ứng dụng đang chạy. Mặc định là 'Overleaf (Community Edition)'. | | `OVERLEAF_MONGO_URL` và `MONGO_URL` | URL của cơ sở dữ liệu Mongo sẽ dùng. | | `OVERLEAF_REDIS_HOST` và `REDIS_HOST` | Tên máy chủ của phiên bản Redis sẽ dùng. Cả hai đều được yêu cầu (xem [ghi chú phát hành](broken://pages/24368564b254db13cfc0c000428ac7211ccc6ecb#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PORT` và `REDIS_PORT` | Cổng của phiên bản Redis sẽ dùng. Cả hai đều được yêu cầu (xem [ghi chú phát hành](broken://pages/24368564b254db13cfc0c000428ac7211ccc6ecb#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PASS` và `REDIS_PASSWORD` | Mật khẩu dùng khi kết nối tới Redis (nếu áp dụng). **Cả hai** biến môi trường cần được đặt. Xem [bật xác thực bằng mật khẩu](broken://pages/744965f0f6c0675b1a887e02be92cedded2c7ba4) để biết thêm thông tin. | | `OVERLEAF_REDIS_TLS` |

Nếu được đặt thành true, cho phép kết nối tới một phiên bản Redis yêu cầu TLS.

Lưu ý: mTLS hiện chưa được hỗ trợ.

| | `OVERLEAF_NAV_TITLE` | Đặt tiêu đề tab của ứng dụng. | | `OVERLEAF_SESSION_SECRET` | Một chuỗi ngẫu nhiên được dùng để bảo vệ token; nếu cân bằng tải thì giá trị này cần được đặt giống nhau trên tất cả các máy. Nếu chỉ chạy 1 phiên bản thì người dùng không cần đặt. | | `OVERLEAF_COOKIE_SESSION_LENGTH` | Cho phép bạn ghi đè thời gian hết hạn mặc định của cookie phiên là 5 ngày. Giá trị ghi đè phải tính bằng mili giây. Ví dụ: để phiên kéo dài 1 giờ, hãy đặt `COOKIE_SESSION_LENGTH=3600000`. (Được thêm vào trong Server Pro 4.2) | | `OVERLEAF_TRUSTED_PROXY_IPS` |

Nếu không đặt, mặc định là loopback. Nếu đặt thủ công, ngoài các IP đáng tin cậy của bạn, bạn cũng phải bao gồm một trong các giá trị loopback, localhost hoặc 127.0.0.1, giá trị này tin cậy phiên bản nginx đang chạy bên trong sharelatex container.

Nếu sử dụng một subnet từ 172.16.0.0/12 (subnet mặc định cho các mạng Docker) cho mạng thông thường của bạn, vui lòng đặt OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\ trong config/variables.env. Trong đó \ là IPAM -> Config -> Subnet giá trị trong docker inspect overleaf\_default, ví dụ OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,172.19.0.0/16. Điều này nhằm ngăn chặn việc giả mạo X-Forwarded các header.

Nếu bạn đang dùng một proxy TLS bên ngoài (tức là không do Overleaf Toolkit quản lý), hãy đảm bảo rằng OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\, ví dụ OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,192.168.13.37.

| | `OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS` | Nếu được đặt thành `true`, sẽ giới hạn lời mời vào dự án đối với các địa chỉ email khớp với tài khoản người dùng hiện có. | | `OVERLEAF_ALLOW_PUBLIC_ACCESS` | Nếu được đặt thành `true`, sẽ cho phép người dùng chưa xác thực xem trang web. Mặc định là `false`, nghĩa là người dùng chưa xác thực sẽ bị chuyển hướng vô điều kiện đến trang đăng nhập khi họ cố xem bất kỳ phần nào của trang web. Lưu ý, việc đặt tùy chọn này không hề vô hiệu hóa xác thực hay bảo mật dưới bất kỳ hình thức nào. Tùy chọn này là cần thiết nếu người dùng của bạn dự định công khai dự án của họ và cho phép người dùng chưa xác thực xem các dự án đó. | | `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | Nếu được đặt thành `true`, sẽ cho phép người dùng ẩn danh xem và chỉnh sửa các dự án được chia sẻ qua [chia sẻ liên kết](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) tính năng. | | `OVERLEAF_DISABLE_LINK_SHARING` | Vô hiệu hóa [chia sẻ liên kết](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) tính năng. | | `EMAIL_CONFIRMATION_DISABLED` | Khi được đặt thành `true` banner yêu cầu xác nhận email sẽ không được hiển thị. | | `ADDITIONAL_TEXT_EXTENSIONS` | Một mảng chuỗi để cấu hình các phần mở rộng bổ sung cho các tệp có thể chỉnh sửa. | | `OVERLEAF_STATUS_PAGE_URL` | URL trang trạng thái tùy chỉnh (Được thêm vào trong Server Pro 3.4.0), ví dụ `status.example.com`. | | `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | Đặt thành `'false'` để ngăn các dự án mới được khởi tạo với Full Project History (Được thêm vào trong Server Pro 3.5.0). | | `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | Đặt thành `'false'` để ngăn các dự án mới hiển thị Full Project History thay vì lịch sử cũ (Được thêm vào trong Server Pro 3.5.0). | | `ENABLE_CRON_RESOURCE_DELETION` | Đặt biến môi trường này thành `true` để bật tính năng tự động dọn dẹp các dự án và người dùng đã xóa sau 90 ngày. | | `OVERLEAF_USER_HARD_DELETION_DELAY` |

Dùng để chỉnh sửa thời gian hết hạn của người dùng đã xóa. Cấu hình bằng mili giây.

Mặc định: 90 ngày

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

Dùng để chỉnh sửa thời gian hết hạn của các dự án đã xóa. Cấu hình bằng mili giây.

Mặc định: 90 ngày

| | `MAX_UPLOAD_SIZE` |

Kiểm soát kích thước tối đa của một lần tải lên riêng lẻ, tính bằng megabyte. Mặc định là 50.

Chú ý: Biến này chỉ là một số thô, không có đơn vị (MB) hay bao bọc.

| | `COMPILE_SIZE_LIMIT` | Kiểm soát kích thước tối đa của phần thân yêu cầu, tính bằng byte. Đây là tổng kích thước của tất cả các tệp tài liệu trong dự án (`main.tex`, `references.bib` (nếu không được liên kết) v.v.), cần được gửi trong yêu cầu biên dịch ban đầu tới dịch vụ CLSI. | | `COMPILE_TIMEOUT` | Khoảng thời gian, tính bằng giây, được phép để hoàn tất việc biên dịch. Để biết thêm thông tin, xem [Cập nhật thời gian chờ biên dịch của dự án](broken://pages/d91266cf7c22a36fd09d0aebc52a06d86059228d#updating-project-compile-timeout). | | `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | Một độ trễ có thể cấu hình giữa việc kết nối lại êm của trình soạn thảo, xả dữ liệu và tắt container để giảm thiểu nguy cơ mất dữ liệu. | | `SECCOMP_PROFILE` |

Đặt biến môi trường này thành một đường dẫn trên Docker máy chủ máy trỏ tới hồ sơ SECCOMP. Bạn có thể tải xuống một bản sao của hồ sơ tại đây.

Hiện cần thiết cho các triển khai Podman khi dùng Sandboxed Compiles.

| | `OVERLEAF_DISABLE_CHAT` | Nếu được đặt thành `true`, vô hiệu hóa tính năng chat trong dự án. | | `OVERLEAF_LOGIN_SUPPORT_TEXT` | Khi được đặt, có thể dùng để hiển thị thông tin hỗ trợ bên dưới nút đăng nhập. Văn bản sẽ được hiển thị trên màn hình đăng nhập và có thể dùng để hướng người dùng tới bộ phận hỗ trợ nội bộ hoặc cung cấp hướng dẫn liên quan đến đăng nhập, tạo tài khoản, v.v. | | `ALLOW_MONGO_ADMIN_CHECK_FAILURES` |

Nếu được đặt thành true, cho phép các kiểm tra khởi động MongoDB thất bại mà không ngăn việc triển khai khởi động. Điều này có thể cần nếu bạn dùng cơ sở dữ liệu MongoDB mà người dùng cơ sở dữ liệu của bạn không có vai trò clusterParameterReader clusterParameterReader.

Để được trợ giúp về việc tạo một vai trò tùy chỉnh, xem tại đây.

| | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | Cho phép tách riêng **history-v1** điểm cuối cho lưu lượng nội bộ (`web` dịch vụ → `history-v1` dịch vụ, cả hai trong `sharelatex` container) và lưu lượng bên ngoài (`git-bridge` → `history-v1`, chạy trong các container riêng biệt). | | `OVERLEAF_MAINTENANCE_MESSAGE` và `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | Được dùng để tùy chỉnh tiêu đề và nội dung của trang Bảo trì. Không thể dùng với `OVERLEAF_STATUS_PAGE_URL`. | {% hint style="info" %} Có thể áp đặt các hạn chế mật khẩu đối với người dùng khi sử dụng hệ thống đăng nhập Overleaf (tài khoản cục bộ), không phải tùy chọn SSO như LDAP. Với tài khoản SSO, chính sách mật khẩu sẽ do nhà cung cấp danh tính hoặc dịch vụ thư mục của bạn thực thi, đồng thời hỗ trợ xác thực đa yếu tố. {% endhint %} --- # 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/cau-hinh/overleaf-toolkit/environment-variables.md?ask=&goal= ``` `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.