> 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/ru/konfiguraciya/overleaf-toolkit/environment-variables.md). # Переменные среды На этой странице описаны переменные окружения, поддерживаемые в `config/variables.env` файле для развёртываний Toolkit. Параметр `config/variables.env` файл состоит из определений переменных в форме `NAME=value`; строки, начинающиеся с `#` обрабатываются как комментарии. {% hint style="info" %} Необходимо пересоздать контейнеры Docker после изменения чего-либо в `overleaf.rc` или `variables.env` выполнив `bin/up`. {% endhint %} ### Все версии Эти переменные окружения совместимы с Server CE и Server Pro и обеспечивают простой путь миграции между этими двумя локальными версиями. Их также можно использовать как в развёртываниях Toolkit, так и Docker Compose. {% hint style="info" %} Ранее эти переменные окружения имели префикс `SHARELATEX_` вместо `OVERLEAF_`. {% endhint %} | Имя | Описание | | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OVERLEAF_SITE_URL` | Где ваш экземпляр Overleaf общедоступен. Это используется в публичных ссылках и при подключении через веб-сокеты, поэтому должно быть настроено правильно! | | `OVERLEAF_ADMIN_EMAIL` | Адрес электронной почты, по которому пользователи могут связаться с человеком, управляющим сайтом. | | `OVERLEAF_APP_NAME` | Имя, отображаемое при упоминании работающего приложения. По умолчанию — 'Overleaf (Community Edition)'. | | `OVERLEAF_MONGO_URL` и `MONGO_URL` | URL базы данных Mongo, которую нужно использовать. | | `OVERLEAF_REDIS_HOST` и `REDIS_HOST` | Имя хоста экземпляра Redis, который следует использовать. Требуются оба (см. [примечания к выпуску](broken://pages/8a4b4ac045f2909647d2a3b1023fa7f345f58bbe#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PORT` и `REDIS_PORT` | Порт экземпляра Redis, который следует использовать. Требуются оба (см. [примечания к выпуску](broken://pages/8a4b4ac045f2909647d2a3b1023fa7f345f58bbe#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PASS` и `REDIS_PASSWORD` | Пароль, используемый при подключении к Redis (если применимо). **Обе** переменные окружения должны быть заданы. См. [включение аутентификации по паролю](broken://pages/b707b7375461821be089c91ecb3a566ab4f7943b) для получения дополнительной информации. | | `OVERLEAF_REDIS_TLS` |

Если установлено в true, позволяет подключение к экземпляру Redis, требующему TLS.

Примечание: mTLS в настоящее время не поддерживается.

| | `OVERLEAF_NAV_TITLE` | Установите заголовок вкладки приложения. | | `OVERLEAF_INVITE_TOKEN_SECRET` |

Требуется. Случайная строка, используемая для защиты токенов совместного доступа к проектам (добавлено в Server Pro 6.2.0).

Минимум символов: 16

| | `OVERLEAF_SESSION_SECRET` | Случайная строка, используемая для защиты токенов; при балансировке нагрузки её нужно задать одинаковой на всех узлах. Если запущен только 1 экземпляр, пользователю не нужно задавать её. | | `OVERLEAF_COOKIE_SESSION_LENGTH` | Позволяет переопределить стандартное время истечения срока действия cookie-сеанса, равное 5 дням. Значение переопределения должно быть в миллисекундах. Пример: чтобы сеанс длился 1 час, установите `COOKIE_SESSION_LENGTH=3600000`. (Добавлено в Server Pro 4.2) | | `OVERLEAF_TRUSTED_PROXY_IPS` |

Если не задано, по умолчанию loopback. Если задаёте вручную, помимо доверенных IP-адресов, вы также должны включить один из loopback, localhost или 127.0.0.1, который доверяет экземпляру nginx, работающему внутри контейнера sharelatex контейнера.

Если вы используете подсеть из 172.16.0.0/12 (подсеть по умолчанию для сетей Docker) для вашей обычной сети, пожалуйста, установите OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\ в вашем config/variables.env. Где \ — это IPAM -> Config -> Subnet значение в docker inspect overleaf\_default, например OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,172.19.0.0/16. Это нужно для предотвращения подделки X-Forwarded заголовков.

Если вы используете внешний TLS-прокси (то есть не управляемый Overleaf Toolkit), пожалуйста, убедитесь, что OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\, например OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,192.168.13.37.

| | `OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS` | Если установлено в `true`, ограничит приглашения в проекты адресами электронной почты, соответствующими существующим учётным записям пользователей. | | `OVERLEAF_ALLOW_PUBLIC_ACCESS` | Если установлено в `true`, позволит неаутентифицированным пользователям просматривать сайт. По умолчанию `false`, что означает, что неаутентифицированные пользователи будут безусловно перенаправляться на страницу входа, когда попытаются просмотреть любую часть сайта. Обратите внимание: установка этой опции никоим образом не отключает аутентификацию или безопасность. Эта опция необходима, если ваши пользователи собираются сделать свои проекты общедоступными и позволить неаутентифицированным пользователям просматривать эти проекты. | | `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | Если установлено в `true`, позволит анонимным пользователям просматривать и редактировать проекты, которыми поделились через функцию [общего доступа по ссылке](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) . | | `OVERLEAF_DISABLE_LINK_SHARING` | Отключает [общего доступа по ссылке](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) . | | `EMAIL_CONFIRMATION_DISABLED` | Когда установлено в `true` баннер с запросом подтверждения электронной почты не будет отображаться. | | `ADDITIONAL_TEXT_EXTENSIONS` | Массив строк для настройки дополнительных расширений для редактируемых файлов. | | `DEFAULT_LATEX_COMPILER` |

Используется для установки компилятора по умолчанию, применяемого новыми проектами. (Добавлено в Server Pro 6.2.0).

Параметры: pdflatex, latex, xelatex или lualatex

| | `OVERLEAF_STATUS_PAGE_URL` | Пользовательский URL страницы статуса (добавлено в Server Pro 3.4.0), например `status.example.com`. | | `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | Установите `'false'` чтобы новые проекты не инициализировались с Full Project History (добавлено в Server Pro 3.5.0). | | `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | Установите `'false'` чтобы новые проекты не отображали Full Project History вместо устаревшей истории (добавлено в Server Pro 3.5.0). | | `ENABLE_CRON_RESOURCE_DELETION` | Установите эту переменную окружения в `true` чтобы включить автоматическую очистку удалённых проектов и пользователей после 90 дней. | | `OVERLEAF_USER_HARD_DELETION_DELAY` |

Используется для изменения срока истечения удалённых пользователей. Настраивается в миллисекундах.

По умолчанию: 90 дней

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

Используется для изменения срока истечения удалённых проектов. Настраивается в миллисекундах.

По умолчанию: 90 дней

| | `MAX_UPLOAD_SIZE` |

Управляет максимальным размером отдельной загрузки в мегабайтах. По умолчанию 50.

Внимание: Это просто необработанное число, без единицы (МБ) или обёртки.

| | `COMPILE_SIZE_LIMIT` | Управляет максимальным размером тела запроса в байтах. Это сумма всех размеров файлов документов внутри проекта (`main.tex`, `references.bib` (если не связаны) и т. д.), которую нужно отправить в начальном запросе на компиляцию в сервис CLSI. | | `COMPILE_TIMEOUT` | Количество секунд, отведённое на завершение компиляции. Для получения дополнительной информации см. [Обновление тайм-аута компиляции проекта](broken://pages/76d74cb542ff4b2024070201671a4a02dc0991a1#updating-project-compile-timeout). | | `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | Настраиваемая задержка между плавным переподключением редактора, сбросом данных и завершением работы контейнера для снижения риска потери данных. | | `SECCOMP_PROFILE` |

Установите эту переменную окружения в путь на Docker хост-машине который указывает на профиль SECCOMP. Вы можете скачать копию профиля здесь.

В настоящее время требуется для развёртываний Podman при использовании изолированных компиляций.

| | `OVERLEAF_DISABLE_CHAT` | Если установлено в `true`, отключает встроенную в проект функцию чата. | | `OVERLEAF_LOGIN_SUPPORT_TEXT` | Когда установлено, может использоваться для отображения информации о поддержке под кнопкой входа. Текст будет показан на экране входа и может использоваться, чтобы направлять пользователей во внутреннюю поддержку или предоставлять инструкции, связанные со входом, созданием учётных записей и т. д. | | `ALLOW_MONGO_ADMIN_CHECK_FAILURES` |

Если установлено в true, позволяет проверкам запуска MongoDB завершаться с ошибкой и не препятствовать запуску развёртывания. Это может потребоваться, если вы используете базу данных MongoDB, где пользователь базы данных не имеет роли clusterParameterReader

Для помощи в создании пользовательской роли см. здесь.

| | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | Позволяет разделить **history-v1** конечную точку для внутреннего трафика (`web` service → `history-v1` service, оба в `контейнера sharelatex` контейнере) и внешнего трафика (`git-bridge` → `history-v1`, работающих в отдельных контейнерах). | | `OVERLEAF_MAINTENANCE_MESSAGE` и `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | Используется для настройки заголовка и содержимого страницы обслуживания. Не может использоваться с `OVERLEAF_STATUS_PAGE_URL`. | {% hint style="info" %} При использовании системы входа Overleaf (локальные учётные записи), а не SSO-варианта, такого как LDAP, можно применять к пользователям ограничения на пароли. Для SSO-учётных записей политики паролей будут применяться вашим поставщиком удостоверений или службой каталогов, что дополнительно обеспечивает поддержку многофакторной аутентификации. {% 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/ru/konfiguraciya/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.