Переменные окружения - Ayakaleaf Pro

На этой странице описаны переменные окружения, поддерживаемые в файле config/variables.env для развёртываний с помощью Toolkit. Файл config/variables.env состоит из определений переменных вида NAME=value; строки, начинающиеся с #, считаются комментариями.

После любых изменений в overleaf.rc или variables.env необходимо пересоздать Docker-контейнеры, выполнив bin/up.

Все версии

Эти переменные окружения совместимы с Server CE и Server Pro и обеспечивают простой путь миграции между этими двумя локальными версиями. Их также можно использовать как в развёртываниях с Toolkit, так и в развёртываниях с Docker Compose.

Ранее эти переменные окружения имели префикс SHARELATEX_ вместо OVERLEAF_.

Имя	Описание
`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. Обязательны обе переменные (см. примечания к выпускам).
`OVERLEAF_REDIS_PORT` и `REDIS_PORT`	Порт используемого экземпляра Redis. Обязательны обе переменные (см. примечания к выпускам).
`OVERLEAF_REDIS_PASS` и `REDIS_PASSWORD`	Пароль для подключения к Redis (если требуется). Необходимо задать обе переменные окружения. Подробнее см. включение аутентификации по паролю.
`OVERLEAF_REDIS_TLS`	Если установлено значение `true`, разрешает подключение к экземпляру Redis, требующему TLS. Примечание: mTLS в настоящее время не поддерживается.
`OVERLEAF_NAV_TITLE`	Задаёт заголовок вкладки приложения.
`OVERLEAF_HEADER_IMAGE_URL_LIGHT` и `OVERLEAF_HEADER_IMAGE_URL_DARK`	URL собственных логотипов в заголовке для светлой и тёмной тем (добавлено в 6.3.0). Если переменная для конкретной темы не задана, используется `OVERLEAF_HEADER_IMAGE_URL`. См. Branding.
`OVERLEAF_LINKED_URL_OUTBOUND_PROXY`	URL HTTP(S)-прокси для получения внешних связанных файлов и внешних ZIP- или TeX-ресурсов через API Open in Overleaf. Доступно начиная с повторно выпущенной версии Ayakaleaf Pro `6.3.0` (3 октября 2026 г.). Оставьте пустым для прямого подключения. Пример: `OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128`. Настройка и ограничения сетевого доступа описаны в разделе Outbound Proxy.
`OVERLEAF_INVITE_TOKEN_SECRET`	Обязательная. Случайная строка, используемая для защиты токенов совместного доступа к проектам (добавлено в Server Pro 6.2.0). Минимальное количество символов: 16
`OVERLEAF_SESSION_SECRET`	Случайная строка, используемая для защиты токенов; при балансировке нагрузки на всех машинах должен быть задан один и тот же токен. Если запущен только один экземпляр, пользователю не нужно её задавать.
`OVERLEAF_COOKIE_SESSION_LENGTH`	Позволяет переопределить срок действия сессионного cookie, по умолчанию равный 5 дням. Значение указывается в миллисекундах. Пример: чтобы сессия длилась 1 час, задайте `COOKIE_SESSION_LENGTH=3600000`. (Добавлено в Server Pro 4.2)
`OVERLEAF_TRUSTED_PROXY_IPS`	Если не задано, по умолчанию используется `loopback`. При ручной настройке помимо доверенных IP-адресов необходимо также указать `loopback` (или `127.0.0.1`), что означает доверие к экземпляру nginx, работающему внутри контейнера sharelatex. Принимаются только IP-адреса и диапазоны CIDR: не добавляйте имена хостов, например `localhost`, иначе Overleaf не запустится и будет возвращать `502 Bad Gateway`. Если для вашей обычной сети используется подсеть из `172.16.0.0/12` (подсеть по умолчанию для сетей Docker), задайте `OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network>` в `config/variables.env`, где `<network>` — значение `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,<ip-of-your-tls-proxy>`, например `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`, анонимные пользователи смогут просматривать и редактировать проекты, к которым открыт доступ с помощью функции совместного доступа по ссылке.
`OVERLEAF_DISABLE_LINK_SHARING`	Отключает функцию совместного доступа по ссылке.
`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`. Внимание: значение этой переменной — просто число, без единицы измерения (MB) и без обёрток. Общий размер загружаемого файла `.zip` в распакованном виде ограничен шестикратным значением этой переменной (по умолчанию 300 МБ).
`COMPILE_SIZE_LIMIT`	Управляет максимальным размером тела запроса в байтах. Это суммарный размер всех файлов документов в проекте (`main.tex`, `references.bib` (если не связан) и т. д.), которые необходимо отправить в первоначальном запросе на компиляцию в сервис CLSI.
`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` → сервис `history-v1`, оба в контейнере `sharelatex`) и внешнего трафика (`git-bridge` → `history-v1`, работающие в отдельных контейнерах).
`OVERLEAF_MAINTENANCE_MESSAGE` и `OVERLEAF_MAINTENANCE_MESSAGE_HTML`	Используются для настройки заголовка и содержимого страницы технического обслуживания. Нельзя использовать вместе с `OVERLEAF_STATUS_PAGE_URL`.

При использовании системы входа Overleaf (локальных учётных записей), а не варианта SSO, такого как LDAP, можно применять к пользователям ограничения на пароли. Для учётных записей SSO политики паролей применяются вашим поставщиком удостоверений или службой каталогов, что дополнительно позволяет поддерживать многофакторную аутентификацию.

Последнее изменение 4 октября 2026 г.