> 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/ko/maintenance/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`    | 사용자 ID(--export-all을 사용하는 경우를 제외하고 필수 `--export-all` 또는 `--project-id`) |
| `--project-id` | 단일 프로젝트 내보내기(**사용할 수** 없습니다 `--user-id` 또는 `--export-all`)              |
| `--list`       | 사용자의 프로젝트 나열(**사용할 수** 없습니다 `--output`)                                 |
| `--output`     | 출력 zip 파일(단일 내보내기 작업용)                                                  |
| `--export-all` | 모든 사용자의 프로젝트를 내보내기(--output-dir 필요 `--output-dir`)                      |
| `--output-dir` | 모든 사용자의 내보내기 파일을 저장할 디렉터리                                               |
| `--log-level`  | 지원되는 로그 수준: `추적`\|`디버그`\|`정보`\|`경고`\|`오류`\|`치명적`                        |

### **사용법**

모든 사용자의 프로젝트를 내보내려면 다음 명령을 사용하세요:

{% 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 Editition <= 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://overleaf-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.
