> 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/obsluzhivanie/data-and-backups/exporting-projects.md).

# Экспорт проектов

В Server Pro и Community Edition `5.4.0` мы включили скрипт, который позволяет администраторам экспортировать все проекты пользователя (включая те, что всё ещё видны в **Удалённые** и **Корзина** папках) в каталог на диске.

{% hint style="info" %}
Результат выполнения этого скрипта такой же, как если бы вы вручную скачали ZIP со всеми проектами из панели проектов пользователя. Перед началом загрузки скрипт сбросит все ожидающие изменения, чтобы экспорт содержал последнюю версию проекта.
{% endhint %}

### Ограничения

Скрипт экспорта имеет следующие ограничения:

* Никакие настройки проекта, такие как имя образа TeX Live или компилятор, не экспортируются. Их нужно задать при загрузке проекта в учётную запись пользователя.
* Экспортированные проекты не содержат историю версий.
* Информация о соавторах не сохраняется. Проекты потребуется расшарить заново. При использовании шаринга по ссылке ссылки Просмотр и Редактирование будут сгенерированы заново (они не будут такими же, как раньше).
* Комментарии и информация об отслеживаемых изменениях не будут экспортированы.
* История чата проекта не будет экспортирована.

{% hint style="danger" %}
Этот скрипт **не** не предназначен для замены полной резервной копии системы. Чтобы гарантировать, что вы сможете восстановить свой экземпляр в сценарии аварийного восстановления, мы **настоятельно** рекомендуем делать [консистентную резервную копию](https://docs.overleaf.com/on-premises/maintenance/#performing-a-consistent-backup).
{% endhint %}

### **Флаги**

| Имя            | Описание                                                                              |
| -------------- | ------------------------------------------------------------------------------------- |
| `--help`       | Показать справку                                                                      |
| `--user-id`    | ID пользователя (обязательно, если не используется `--export-all` или `--project-id`) |
| `--project-id` | Экспортировать один проект (**нельзя** использовать с `--user-id` или `--export-all`) |
| `--list`       | Список проектов пользователя (**нельзя** использовать с `--output`)                   |
| `--output`     | Выходной ZIP-файл (для операций экспорта одного проекта)                              |
| `--export-all` | Экспортировать проекты всех пользователей (требует `--output-dir`)                    |
| `--output-dir` | Каталог для хранения экспортных файлов всех пользователей                             |
| `--log-level`  | Поддерживаемые уровни логирования: `trace`\|`debug`\|`info`\|`warn`\|`error`\|`fatal` |

### **Использование**

Используйте следующую команду, чтобы экспортировать проекты всех пользователей:

{% code overflow="wrap" %}

```bash
# Пользователи Overleaf Toolkit
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"

# Пользователи устаревшего docker-compose.yml
docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"
```

{% endcode %}

{% hint style="info" %}
Если вы используете Server Pro или Community Edition <= 3.5.13, вам нужно будет изменить приведённый выше пример, чтобы использовать **`export-legacy-user-projects.js`** скрипт.
{% endhint %}

### **Завершение**

После завершения экспорта вы сможете получить доступ к файлам через каталог на хосте, примонтированный как bind mount к **/var/lib/overleaf** в вашем **docker-compose.yml** файле или в `OVERLEAF_DATA_PATH` переменной окружения в **config/overleaf.rc** файле, если вы используете Toolkit.

{% hint style="info" %}
Overleaf в настоящее время позволяет дублировать имена проектов. Если в проекте пользователя есть дубликат, эти проекты всё равно будут добавлены в ZIP-экспорт пользователя, но при распаковке будет присутствовать только одна версия. В Linux, `unzip -B` будет записывать файлы с одинаковым именем как резервные копии вместо перезаписи.
{% 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/obsluzhivanie/data-and-backups/exporting-projects.md?ask=<question>&goal=<endgoal>
```

`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.
