Перейти к основному содержанию
Здесь мы собрали ответы на некоторые часто задаваемые вопросы об Ayakaleaf Pro.

Общие вопросы

Нет. Ayakaleaf Pro полностью бесплатен. Это не пробная версия, и лицензия для него не требуется.
Да. Ayakaleaf Pro включает все функции Overleaf Server Pro, в том числе интеграцию Git-Bridge. Он также включает некоторые функции SaaS-платформы Overleaf. Мы продолжаем развивать и улучшать Ayakaleaf Pro.
Overleaf Server Pro стоит около $300 за пользователя в год. Требуется не менее 10 лицензий, поэтому стоимость развёртывания начинается примерно с $3,000 в год. В небольших государственных контрактах США годовая стоимость составляет около $320–$370 за пользователя. Это делает Server Pro дорогим решением, особенно для небольших команд. Задокументированные закупки и цены см. в разделе #information-and-price-about-overleaf-server-pro.
Overleaf Server Pro часто используется государственными организациями. Они развёртывают его в частных сетях и строго контролируют доступ. Чтобы защитить конфиденциальные данные, включённые в него функции не обмениваются данными со сторонними сервисами. Если вам нужны GitHub Sync, ИИ или аналогичные функции, требующие подключения к внешним сервисам, Overleaf рекомендует оформить подписку на свою SaaS-платформу.
Ayakaleaf Pro — проект с открытым исходным кодом. Мы проверяем код с помощью таких инструментов, как Codex Security, чтобы повысить его безопасность и надёжность. Если вы не включаете синхронизацию данных со сторонними сервисами, ваши данные остаются на вашем сервере. Ayakaleaf Pro не содержит телеметрии, отправляющей ваши данные куда-либо.
Мы приложим все усилия, чтобы поддерживать этот проект в долгосрочной перспективе.
Ayakaleaf Pro — это форк сообщества. Его код и интегрированные функции созданы благодаря вкладу сообщества. Он распространяется по лицензии AGPL v3. Развёртывания соответствуют этой лицензии при выполнении её требований.
Изначально, в 2024 году, проект назывался Overleaf Pro. На какое-то время разработка приостановилась, а затем возобновилась в конце 2025 года. В первом квартале 2026 года Overleaf переименовал свой тарифный план с функциями ИИ в Pro. Кроме того, сообщество отмечало, что название Overleaf Pro может создавать риски, связанные с товарными знаками и выдачей себя за другой продукт. Пользователи могли решить, что это официальный проект.Чтобы избежать этой путаницы, мы переименовали проект в Ayakaleaf Pro. Название можно читать как «Ayaka-notes Overleaf Pro». Сопровождающий проекта (можете называть меня ayaka!) участвует в развитии сообщества Overleaf со студенческих лет, то есть уже более пяти лет. Этот опыт подкрепляет наше обязательство по долгосрочному сопровождению.
С 2026 года сообщество open source выпустило множество редакторов LaTeX, созданных с помощью ИИ, включая OpenAI Prism. Ayakaleaf Pro хранит ваши данные и сервисы на вашем собственном сервере. Это даёт вам непосредственный контроль над развёртыванием и данными.У многих экспериментальных редакторов сообщества нет устоявшегося плана долгосрочного сопровождения. Сторонние платформы компиляции LaTeX также могут прекратить работу, если у них недостаточно пользователей или доходов. Ayakaleaf Pro предоставляет весь исходный код и позволяет размещать все сервисы на собственных серверах. Даже если сопровождение прекратится, ваш существующий самостоятельно размещённый сервис сможет продолжить работу.
Он был переименован в ayaka-notes/ayakaleaf-pro вместе с переименованием проекта (см. Q08). Он не был архивирован или заменён: это тот же самый репозиторий, и GitHub перенаправляет старые ссылки и удалённые репозитории Git ayaka-notes/overleaf-pro на новое имя. Docker-образ сохраняет своё имя, ghcr.io/ayaka-notes/overleaf-pro, поэтому менять config/overleaf.rc или config/version не нужно.

Возможности

Актуальный список функций смотрите в нашей документации. Если вы хотите, чтобы мы добавили какую-либо функцию, создайте issue (запрос на функцию) на GitHub. Мы постараемся реализовать запрошенные функции, но разработка требует времени, и мы не можем гарантировать, что каждая функция появится сразу.
Мы приветствуем вклад в проект, но принятие не гарантируется. Мы оцениваем каждый PR с учётом его влияния на базовый код Overleaf, нагрузки на сопровождение и пользы для пользователей. Мы постараемся принимать и сопровождать ценные доработки.Однако мы можем отклонить PR, которые вносят чрезмерные изменения, состоят из непроверенного или плохо понятого кода, сгенерированного ИИ («вайб-кодинг»), или добавляют функции, которые будет сложно сопровождать в долгосрочной перспективе.
Как правило, мы обновляем документацию при выпуске каждой новой функции. Подробные инструкции по настройке и описание доступных переменных окружения см. в соответствующем разделе документации.
Python Runner выполняет Python в браузере пользователя с помощью Pyodide 0.29.3, а не на сервере. Он загружает пакеты, которые импортирует ваш код, из пакетов, встроенных в Pyodide, таких как NumPy, pandas и Matplotlib. Пакеты, установленные через pip, и другие пакеты недоступны. Настраивать на сервере ничего не нужно.
Нет. У средства проверки орфографии нет словаря для японского и китайского языков, поэтому этих языков нет в списке языков проверки орфографии. Пользователи могут отключить проверку орфографии для проекта в настройках редактора.Чтобы слово больше не отмечалось как написанное с ошибкой, щёлкните по нему правой кнопкой мыши и выберите Add to dictionary. Добавленные слова сохраняются в вашей учётной записи и применяются ко всем вашим проектам. Чтобы просмотреть или удалить их, откройте настройки редактора, затем Spelling and language → Dictionary → Edit. Добавление слов не добавляет новый язык проверки орфографии.
Установщика плагинов нет. Функции — это модули в services/web/modules исходного кода, которые встраиваются в Docker-образ и включаются с помощью настроек, описанных в этой документации. Чтобы добавить собственную функцию, добавьте модуль в исходный код и соберите собственный образ.

Развёртывание

Большинству пользователей мы рекомендуем выполнять развёртывание с помощью Toolkit. Поддержка Kubernetes является экспериментальной: в разделе С помощью Kubernetes приведены манифесты, которые мы протестировали с одной или несколькими репликами, однако кластер усложняет эксплуатацию и сопровождение. Изолированные компиляции создают свои контейнеры компиляции через сокет Docker, поэтому на каждом узле, где работает Ayakaleaf Pro, нужен Docker Engine. Мы не предоставляем конфигурации для CRI-O, Podman или Quadlet.
Обратитесь к нашему руководству по горизонтальному масштабированию. Вы можете развернуть несколько экземпляров Overleaf и настроить балансировщик нагрузки для распределения трафика между ними.
Если у вас есть экземпляр Overleaf Server Pro, мы будем рады помочь вам перейти на Ayakaleaf Pro. Свяжитесь с нами по электронной почте или через issues.
Нет. Ayakaleaf Pro должен обслуживаться из корня домена. Используйте отдельный домен или поддомен, например https://overleaf.example.com.
Да. Toolkit работает в Linux, macOS с Docker Desktop и Windows с WSL 2 и Docker Desktop. Для общих и рабочих (production) серверов мы рекомендуем Linux. Руководства для macOS и Windows включают настройку изолированных компиляций.Мы не предоставляем отдельный docker-compose.yml. Чтобы посмотреть конфигурацию Compose, которую использует Toolkit, выполните bin/docker-compose config в каталоге Toolkit.
Скрипта удаления нет. В каталоге Toolkit:
  1. Остановите и удалите контейнеры командой bin/docker-compose down.
  2. Удалите данные. По умолчанию они находятся в каталоге data/ в Toolkit. Если вы изменяли OVERLEAF_DATA_PATH, MONGO_DATA_PATH, REDIS_DATA_PATH или GIT_BRIDGE_DATA_PATH в config/overleaf.rc, удалите и эти каталоги. Это действие необратимо, поэтому сначала создайте резервную копию, если данные могут понадобиться.
  3. Удалите каталог Toolkit.
  4. Удалите Docker-образы, список которых можно получить командой docker images: ghcr.io/ayaka-notes/overleaf-pro, образ git-bridge, mongo, redis и образы TeX Live.
Выполняйте эти команды в каталоге Toolkit:
  • bin/stop останавливает все контейнеры, bin/start снова их запускает. Контейнеры сохраняются, поэтому пользователи остаются в системе.
  • bin/up -d создаёт контейнеры и запускает их в фоновом режиме. Выполняйте её после изменения config/variables.env, config/overleaf.rc или config/version: она пересоздаёт контейнеры, конфигурация которых изменилась, и только после этого изменения вступают в силу. bin/stop и bin/start их не применяют.
  • bin/docker-compose restart sharelatex перезапускает только контейнер Overleaf, не применяя изменения конфигурации.
Если пользователи выходят из системы каждый раз, когда bin/up пересоздаёт контейнер, задайте OVERLEAF_SESSION_SECRET, см. раздел «Вопросы и ответы» в Переменные окружения.
В приложении, которое вы создаёте у провайдера, а не в Ayakaleaf Pro. Ни для одной из этих интеграций в config/variables.env нет параметра обратного вызова: Ayakaleaf Pro формирует каждый URL обратного вызова из OVERLEAF_SITE_URL и отправляет его провайдеру, который отклоняет его, если он не совпадает с зарегистрированным для приложения. Поэтому вы регистрируете его только у провайдера и задаёте в OVERLEAF_SITE_URL адрес, который открывают пользователи.Если вы меняете OVERLEAF_SITE_URL, например на новый домен, обновите URL и у каждого провайдера, иначе привязка не будет работать.
По умолчанию всё хранится на локальном диске сервера, в каталоге data/ Toolkit: data/overleaf (файлы проектов, история и результаты компиляции), data/mongo и data/redis. Для экземпляров с числом пользователей менее 1000 мы рекомендуем локальный диск с регулярным резервным копированием.Образ Ayakaleaf Pro занимает около 5 ГБ. Минимум в 40 ГБ, указанный во Введении, нужен для изолированных компиляций (Sandboxed Compiles), образы texlive-full которых занимают около 28 ГБ каждый. Без изолированных компиляций компиляция выполняется внутри контейнера sharelatex с базовой схемой TeX Live и пакетами latexmk, texcount, synctex, etoolbox и xetex, поэтому многие проекты не скомпилируются из-за отсутствующих пакетов. Каталог data/ затем растёт вместе с вашими проектами и их историей; проверить его размер можно командой du -sh data/*.
Да, при условии, что Windows не переходит в спящий режим, а Docker Desktop продолжает работать. Включите Start Docker Desktop when you sign in to your computer, сохраните политики restart: always из Toolkit и отключите автоматический переход в спящий режим и гибернацию при питании от сети. Экран может отключаться; поведение при закрытии крышки ноутбука настраивается отдельно. Закрытие терминала Ubuntu после bin/up -d не останавливает контейнеры, запущенные в фоновом режиме. Выход из Docker Desktop, приостановка его движка или выполнение wsl --shutdown прерывают работу сервиса.Resource Saver в Docker Desktop — это не то же самое, что спящий режим Windows: он срабатывает, когда не запущено ни одного контейнера, поэтому работающий стек Ayakaleaf не считается простаивающим только потому, что никто ничего не редактирует. После перезагрузки Windows настройка запуска при входе всё равно требует, чтобы кто-то вошёл в систему. Проверки и шаги восстановления описаны в разделе Обеспечение доступности экземпляра. Если доступность не должна зависеть от интерактивного входа в систему, мы по-прежнему рекомендуем Linux.
В этом руководстве используется бэкенд WSL 2. Для него нужны включённая в BIOS/UEFI виртуализация процессора, компонент Windows Virtual Machine Platform и работающая установка WSL 2. Полноценный компонент Hyper-V — это отдельный бэкенд Docker Desktop, и он не требуется для этой настройки WSL.Проверьте Диспетчер задач → Производительность → ЦП → Виртуализация и выполните wsl --list --verbose в PowerShell. Ошибки вроде 0x80370102 могут означать, что отключены виртуализация, компонент Windows или загрузочный гипервизор. См. шаги по устранению неполадок установки в Windows со ссылками Microsoft и Docker на способы исправления. После включения нужных компонентов перезагрузите Windows; переустановка Ayakaleaf не исправит движок Docker, который не запускается.

LaTeX

Если включена изолированная компиляция (Sandbox Compiles), компиляция каждого пользователя выполняется в отдельном контейнере Docker и изолирована от компиляций других пользователей. Для Sandbox Compiles Shell Escape включён по умолчанию.
За последние три года мы улучшили наш образ TeX Live Full для Sandbox Compiles. В большинстве случаев проекты, которые компилируются на overleaf.com, корректно компилируются и в Ayakaleaf Pro. Если нужный шрифт недоступен, загрузите его в проект вручную.
Загрузите ваш проект на официальный сайт Overleaf, включите общий доступ по ссылке только для чтения и добавьте эту ссылку в issue на GitHub.Мы изучим и исправим ошибки, из-за которых проект не компилируется в Ayakaleaf Pro, если он успешно компилируется на официальном сайте Overleaf. Проблемы компиляции за пределами этого случая не входят в нашу поддержку.
Последнее изменение 8 ноября 2026 г.