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

# 프로젝트 내보내기

Server Pro 및 커뮤니티 에디션에서 `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 %}

### **완료**

내보내기가 완료되면, 호스트의 다음 위치에 바인드 마운트된 디렉터리를 통해 파일에 접근할 수 있습니다. **/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/ko/maintenance/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.