> 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/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/data-and-backups/..#performing-a-consistent-backup).
{% endhint %}

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

| Имя            | Описание                                                                                         |
| -------------- | ------------------------------------------------------------------------------------------------ |
| `--help`       | Показать справку                                                                                 |
| `--user-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://overleaf-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.
