> 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/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 доступна публично. Это используется в публичных ссылках и при подключении через websockets, поэтому должно быть настроено правильно! | | `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_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` | Массив строк для настройки дополнительных расширений для редактируемых файлов. | | `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.

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

| | `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 host который указывает на профиль SECCOMP. Вы можете скачать копию профиля здесь.

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

| | `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://overleaf-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.