> 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/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 cho các triển khai Toolkit. Trường `config/variables.env` tệp bao 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 vùng chứa 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 và cung cấp một lộ trình di chuyển dễ dàng giữa hai phiên bản 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ó thể truy cập công khai. Biến 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 đúng! | | `OVERLEAF_ADMIN_EMAIL` | Địa chỉ email để người dùng có thể liên hệ với người vận hành 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 cần dùng. | | `OVERLEAF_REDIS_HOST` và `REDIS_HOST` | Tên máy chủ của phiên bản Redis cần dùng. Cả hai đều là bắt buộc (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 cần dùng. Cả hai đều là bắt buộc (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 có áp dụng). **Cả hai** biến môi trường cần được thiết lập. 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_INVITE_TOKEN_SECRET` |

Bắt buộc. Một chuỗi ngẫu nhiên dùng để bảo mật các mã chia sẻ dự án (được thêm trong Server Pro 6.2.0).

Số ký tự tối thiểu: 16

| | `OVERLEAF_SESSION_SECRET` | Một chuỗi ngẫu nhiên được dùng để bảo mật các token; nếu cân bằng tải thì cần đặt cùng một token trên các máy. Nếu chỉ chạy 1 phiên bản thì người dùng không cần tự đặ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 đè nên được 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 trong Server Pro 4.2) | | `OVERLEAF_TRUSTED_PROXY_IPS` | Nếu không được đặt, mặc định là `loopback`. Nếu đặt thủ công, ngoài các IP tin cậy của bạn, bạn cũng phải bao gồm một trong `loopback`, `localhost` hoặc `127.0.0.1`, vốn tin cậy vào phiên bản nginx đang chạy bên trong **sharelatex** vùng chứa.\n\nNếu đang 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à giá trị `IPAM -> Config -> Subnet` 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 tiêu đề.\n\nNếu bạn đang dùng một proxy TLS bên ngoài (tức là không được Overleaf Toolkit quản lý), vui lòng đả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 dự án cho các địa chỉ email tương ứng với các 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ẽ luôn bị chuyển hướng đế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 vô hiệu hóa xác thực hoặc bảo mật theo bất kỳ cách 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 các 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` thì 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. | | `DEFAULT_LATEX_COMPILER` |

Dùng để đặt trình biên dịch mặc định được các dự án mới. (Được thêm trong Server Pro 6.2.0).

Tùy chọn: pdflatex, latex, xelatex hoặc lualatex

| | `OVERLEAF_STATUS_PAGE_URL` | URL trang trạng thái tùy chỉnh (được thêm 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 Lịch sử Toàn bộ Dự án (được thêm 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ị Lịch sử Toàn bộ Dự án thay vì lịch sử cũ (được thêm 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ự độ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 để sửa đổi độ trễ hết hạn của người dùng đã xóa. Được cấu hình bằng mili giây.

Mặc định: 90 ngày

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

Dùng để sửa đổi độ trễ hết hạn của các dự án đã xóa. Được 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) hoặc 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 của tất cả kích thướ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 để một lần biên dịch hoàn tất. Để biết thêm thông tin xem [Cập nhật thời gian chờ biên dịch 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 thấm của trình soạn thảo, xả dữ liệu và tắt vùng chứa để giảm thiểu rủi ro 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 máy **host** Docker 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](https://raw.githubusercontent.com/overleaf/overleaf/365af778b68a7940e08282119dc4ef473e2f0044/services/clsi/seccomp/clsi-profile.json).\n\nHiện cần cho các triển khai Podman khi dùng Biên dịch Trong hộp cát. | | `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 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 và không ngăn việc triển khai khởi động. Điều này có thể cần thiết 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` .\n\nĐể được trợ giúp về việc tạo một vai trò tùy chỉnh, xem [tại đây](broken://pages/398e37b78487325e71f55e70d926add5d319ad7d#creating-a-custom-role). | | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | Cho phép tách **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` vùng chứa) và lưu lượng bên ngoài (`git-bridge` → `history-v1`, chạy trong các vùng chứa riêng biệt). | | `OVERLEAF_MAINTENANCE_MESSAGE` và `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | 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 lên 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 một tùy chọn SSO như LDAP. Với tài khoản SSO, chính sách mật khẩu sẽ được nhà cung cấp nhận dạng hoặc dịch vụ thư mục của bạn thực thi, đồng thời cho phép 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://ayakaleaf-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.