Введение

Развертывание Ayakaleaf Pro с рекомендациями по миграции, требованиям и производительности LaTeX.

Как и Overleaf Server Pro, наш Ayakaleaf Pro поставляется в виде Docker-контейнера и является полноценной заменой «один к одному», которая дополнительно включает такие функции, как SSO через LDAP и SAML2, улучшенная безопасность, отслеживание изменений, комментарии, наша оптимизированная версия TeX Live, шаблоны и панель администратора.

• Если вы просто хотите протестировать возможности Ayakaleaf Pro или попробовать демо-версию, воспользуйтесь нашим руководством using-the-github-codespace.md. В демо-среде используется минимальная установка TeX Live, поэтому некоторые ваши проекты могут не скомпилироваться.
• Если вы никогда раньше не развертывали ни одну из версий Overleaf, сначала установите Docker Engine по инструкции Настройка Docker, а затем установите Overleaf, следуя разделу using-the-toolkit.
• Если у вас уже развернута Community Edition Overleaf, для перехода на Ayakaleaf Pro обратитесь к разделу migrate-from-existing.md.
• Если вы предпочитаете использовать агентов, таких как Claude или Codex, см.: using-claude-or-codex.md.
• Если вам нужно выполнить развертывание в автономной или изолированной среде, см.: air-gapped-offline-deployments.md.
• Если вы уже используете Server Pro, пожалуйста, перед переходом на Ayakaleaf Pro создайте issue и сообщите нам об этом, поскольку данные шаблонов хранятся в немного другом формате. Мы будем рады бесплатно помочь вам перейти с Server Pro на Ayakaleaf Pro.
• Если вы когда-нибудь устанете от нашего Ayakaleaf Pro и захотите вернуться к официальной Overleaf Community Edition, это полностью поддерживается. Никакие ваши данные не будут потеряны. Пользователям официального Overleaf Toolkit достаточно удалить свой YAML-файл переопределений. Пользователям toolkit от ayaka-notes нужно отключить параметр SERVER_PRO. После этого всё вернётся к стандартной Community Edition.

Выберите способ установки в соответствии с вашими потребностями:

С помощью GitHub Codespace

С помощью Toolkit

С помощью Claude или Codex

Развертывание в изолированных/автономных средах

Миграция с существующей установки

​

Требования к оборудованию

Мы провели соответствующие тесты и выяснили, что при запуске Overleaf на сервере с 2 ядрами и 2 ГБ ОЗУ его основные компоненты, построенные преимущественно на Node.js, потребляют около 1 ГБ памяти. Redis и MongoDB могут потребовать ещё 0,5 ГБ, а запуск изолированного Docker-контейнера для компиляции — ещё 0,3 ГБ. Это означает, что сервер с 2 ядрами и 2 ГБ реально способен обрабатывать лишь около одной компиляции одновременно.

• Минимальные требования к оборудованию для установки Ayakaleaf Pro — 2-ядерный процессор и 3 ГБ ОЗУ.
• Из-за размера нашего образа TeX Live для включения изолированной компиляции требуется не менее 40 ГБ дискового пространства.
• Если вы хотите установить полный набор образов TeX Live с 2020 по 2026 год, убедитесь, что у вас есть не менее 150 ГБ свободного места на диске.

Ниже приведены рекомендуемые конфигурации оборудования для различных сценариев использования:

Сценарий использования	Рекомендуемая конфигурация
Личное использование с периодической совместной работой	2 ядра CPU, 4 ГБ ОЗУ, 80 ГБ хранилища
Небольшие команды, до 10 пользователей с умеренной совместной работой	2 ядра CPU, 8 ГБ ОЗУ, 256 ГБ хранилища
Команды среднего размера, до 100 пользователей	4 ядра CPU, 16 ГБ ОЗУ, 1 ТБ хранилища
Крупномасштабные или университетские развертывания	Развертывание в распределённом кластере с хранилищем S3; свяжитесь с нами, если вам нужна помощь с развертыванием

​

Требования к программному обеспечению

С точки зрения программного обеспечения рекомендуем использовать свежую стабильную версию Ubuntu (например, Ubuntu 24.04 в 2025–2026 годах, Ubuntu 22.04 в 2023–2024 годах) вместе с последней стабильной версией Docker.

Стабильность прежде всего: выбирайте самую новую Ubuntu LTS, которая вышла уже некоторое время назад, а не только что выпущенную. Например, по состоянию на октябрь 2026 года Ubuntu 26.04 не поддерживается: она поставляется с ядром Linux 7.0, а MongoDB отказывается запускаться на ядрах Linux с 6.19 по 7.0.13 (подробнее), поэтому используйте Ubuntu 24.04.

Мы не рекомендуем развертывать Ayakaleaf Pro в Windows или других неподдерживаемых операционных системах, например CentOS, поскольку во время установки и эксплуатации могут возникнуть проблемы совместимости или непредвиденные неполадки.

Но если вы хотите попробовать развернуть Ayakaleaf Pro на системах с архитектурой ARM или на macOS, мы будем рады, если вы поделитесь своим опытом и отзывами с сообществом.

​

Производительность LaTeX

LaTeX — однопоточная программа, то есть одновременно может использовать только одно ядро процессора. При компиляции одного документа производительность в первую очередь ограничивается тактовой частотой одного ядра CPU. Поэтому чем выше однопоточная производительность вашего процессора, тем быстрее будет компилироваться документ. Большее число ядер полезно только тогда, когда несколько пользователей компилируют документы одновременно.

Например, шаблон ThuThesis компилируется примерно за 6 секунд на Intel Core i9-14900K (5,6 ГГц) и примерно за 13 секунд на экземпляре Azure Standard D2as v5 (2 vCPU, 8 ГиБ ОЗУ) на базе AMD EPYC 7763 (3,2 ГГц).

Разумеется, фактическая производительность компиляции зависит от конфигурации вашего оборудования. Большинство серверных процессоров не работают на таких высоких частотах, как 14900K, поэтому придётся искать компромисс между стоимостью и скоростью компиляции.

Кроме того, мы провели углублённый анализ производительности компиляции LaTeX. Если вам интересно, прочитайте нашу статью в блоге Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host).