> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 백업 명령어

> /backup 명령어 그룹 — Discord 안에서 서버 백업을 만들고, 목록을 보고, 살펴보고, 복원하고, 예약하고, 내보내고, 가져오고, 전부 삭제합니다.

`/backup`은 Discord 안에서 [서버 백업](/ko/server-management/server-backup)을 다룹니다. 하나의 명령어에 **열세 개의 서브커맨드**가 있습니다.

| 요구 사항        | 값                                                 |
| ------------ | ------------------------------------------------- |
| **필요한 권한**   | Manage Server                                     |
| **Vetox 권한** | View Channel, Read Message History — 복원에는 더 필요합니다 |
| **쿨다운**      | 5초                                                |
| **사용 위치**    | 서버 전용. DM에서는 사용할 수 없습니다                           |

<Warning>
  **모든 `/backup` 응답은 본인에게만 보입니다.** 백업 ID는 서버 내용을 여는 열쇠이므로, Vetox는 다른 멤버가 읽을 수 있는 곳에 절대 백업 ID를 남기지 않습니다.
</Warning>

<Note>
  각 서브커맨드는 [명령어 관리](/ko/server-management/command-management)를 통해 개별적으로 비활성화하거나 특정 역할과 채널로 제한할 수 있습니다. `/backup create`는 관리자에게 열어 두고 `/backup load`는 완전히 꺼 두는 식도 가능합니다.
</Note>

## 만들기와 살펴보기

<AccordionGroup>
  <Accordion title="/backup create — 백업 만들기" icon="camera">
    | 옵션         | 필수  | 비고                      |
    | ---------- | --- | ----------------------- |
    | `name`     | 아니요 | 최대 64자. 이름이 있으면 찾기 쉽습니다 |
    | `messages` | 아니요 | 0–250. 요금제의 최대치로 제한됩니다  |

    프리미엄 항목은 요금제가 허용하는 범위까지 자동으로 포함됩니다. 응답에는 새 백업 ID가 담기며, 이후 진행 상황에 따라 갱신됩니다. 백업이 끝나면 응답에 **ID**와 그 백업을 사용할 두 명령어(`/backup info`와 `/backup load`), 그리고 대시보드의 해당 백업 링크가 표시됩니다. Starter에서는 메시지·멤버 데이터·차단·첨부 파일이 저장되지 않았다는 안내도 함께 표시됩니다.

    <Note>
      수동 백업은 서버당 **10분**에 한 번이며, 백업 또는 복원 작업은 한 번에 하나만 실행됩니다. 백업을 만들려면 Administrator 권한이 필요하고, [권한 단계](/ko/server-management/server-backup#권한)가 **소유자만**이면 소유자만 만들 수 있습니다.
    </Note>
  </Accordion>

  <Accordion title="/backup list — 백업 목록 보기" icon="list">
    | 옵션      | 필수  | 비고                                                     |
    | ------- | --- | ------------------------------------------------------ |
    | `page`  | 아니요 | 1부터. 한 페이지에 20개씩                                       |
    | `scope` | 아니요 | **이 서버**(기본값), **이 서버의 채널 백업**, 또는 **모든 서버에서 만든 내 백업** |

    최신순입니다. 자동 백업과 안전 사본은 표시가 붙어 한눈에 구분할 수 있습니다. `scope:mine`은 어느 서버에서 만들었든 본인이 만든 모든 백업을, 그 백업이 나온 서버와 함께 보여 줍니다. 다른 곳에서 만든 백업을 여기로 불러오기 전에 그 ID를 찾는 방법입니다.
  </Accordion>

  <Accordion title="/backup info — 백업에 담긴 내용" icon="circle-info">
    | 옵션          | 필수    | 비고           |
    | ----------- | ----- | ------------ |
    | `backup_id` | **예** | 입력하면 자동완성됩니다 |

    개수, 수집에 사용된 옵션, 크기, 가장 활발했던 채널, 경고, 요금제로 잠겨 있는지 여부, 그리고 대시보드 스냅샷 뷰어의 해당 백업 링크를 보여줍니다. 뷰어에서는 백업에 담긴 채널, 역할, 설정, 차단, 멤버를 모두 살펴볼 수 있습니다.
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id`는 이 옵션을 받는 모든 서브커맨드에서 자동완성되므로 ID를 직접 복사할 일이 없습니다. 사용할 수 있는 백업만 후보로 제시됩니다.
</Tip>

## 복원

<AccordionGroup>
  <Accordion title="/backup load — 백업 복원" icon="rotate-left">
    | 옵션          | 필수    | 비고                              |
    | ----------- | ----- | ------------------------------- |
    | `backup_id` | **예** | 자동완성되며, 다른 서버에서 직접 만든 백업도 포함됩니다 |
    | `messages`  | 아니요   | 0–250. 요금제의 최대치로 제한됩니다          |
    | `options`   | 아니요   | 최대 200자. 아래 문법을 참고하세요           |

    처음 눌렀을 때는 아무것도 복원되지 않습니다. Vetox는 채널과 역할이 몇 개 삭제되고 몇 개 생성되는지, 그리고 Vetox 자신의 역할보다 위에 있어 건드릴 수 없는 역할이 있는지 **예상 결과**를 먼저 보여주며, **확인**과 **취소** 버튼은 **60초** 뒤에 만료됩니다. 확인을 눌러야만 Vetox가 안전 사본을 만들고 복원을 시작합니다.

    <Warning>
      백업을 불러오면 이 서버의 채널과 역할이 교체됩니다. 멤버가 추방되는 일은 없지만, 백업을 만든 이후에 생성된 것은 모두 사라집니다.
    </Warning>

    <Note>
      `/backup load`는 서버의 [권한 단계](/ko/server-management/server-backup#권한)를 따릅니다. 기본값인 **관리자가 파괴적인 작업을 할 수 없음**에서는 Administrator 권한이 있어도 소유자가 아니면 거부됩니다.
    </Note>

    <Note>
      복원과 되돌리기에는 하루 한도가 있습니다 — **서버당 10회**, **1인당 20회**입니다. `/backup load`, `/backup channel load`, 그리고 추적된 변경을 되돌리는 작업이 각각 두 한도에 모두 계산되며, 실패한 복원을 재개하는 것은 계산되지 않습니다.
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — 실행 중인 작업 중단" icon="ban">
    옵션이 없습니다. 이 서버에서 실행 중인 백업 또는 복원을 취소합니다. 체크포인트는 남아 있으므로, 취소한 복원도 대시보드에서 재개할 수 있습니다.
  </Accordion>

  <Accordion title="/backup status — 실행 중인 작업과 적용 중인 한도" icon="heart-pulse">
    옵션이 없습니다. 이 서버에서 실행 중인 작업(종류, 단계, 진행 상황, 경고, 시작 시각)을 보여 주거나 실행 중인 작업이 없음을 알려 줍니다. 10분 쿨다운이 적용 중이면 다음 수동 백업이 가능한 시각을, 복원이 **Discord 생성 한도**에 걸렸다면 그 한도가 풀리는 시각을 보여 줍니다. 실행 중인 작업이 없을 때는 직전 작업이 왜 멈췄는지와 대시보드에서 재개할 수 있는지도 함께 알려 줍니다.
  </Accordion>
</AccordionGroup>

### `options` 문법

`options`는 공백으로 구분된 토큰 목록이며 **왼쪽에서 오른쪽으로** 적용됩니다.

| 토큰                                                                                                         | 효과             |
| ---------------------------------------------------------------------------------------------------------- | -------------- |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | 해당 항목을 **켭니다** |
| 앞에 `!`를 붙이면 — `!members`                                                                                   | 해당 항목을 **끕니다** |
| `*`                                                                                                        | **전부** 켭니다     |
| `!*`                                                                                                       | **전부** 끕니다     |

`options`를 아예 생략하면 Vetox가 기본값을 사용합니다: **`delete-channels channels delete-roles roles settings`** — 멤버, 차단, 고정 메시지, 이모지, 스티커 없이 구조만 전부 교체합니다.

| 예시                                       | 결과                               |
| ---------------------------------------- | -------------------------------- |
| `options:!* roles delete-roles`          | 역할만 — 현재 역할을 지우고 백업의 역할을 다시 만듭니다 |
| `options:!* channels roles settings`     | 구조를 기존 항목에 더합니다 — 삭제되는 것은 없습니다   |
| `options:* !members !bans`               | 멤버 데이터와 차단을 제외한 전부               |
| `options:!delete-channels !delete-roles` | 기본값을 추가 전용으로 바꿉니다                |

<Warning>
  **순서가 중요합니다.** `* !members`는 전부 켠 다음 멤버를 끕니다. `!members *`는 멤버를 끈 다음 멤버를 포함한 전부를 다시 켭니다. 토큰 목록은 왼쪽에서 오른쪽으로 읽으세요.
</Warning>

<Note>
  토큰이 요금제가 허용하는 범위를 넓힐 수는 없습니다 — 요금제 한도가 가장 마지막에 적용됩니다. 알 수 없는 토큰은 무시되지 않고 이름을 지목하며 거부되므로, 오타가 조용히 사라지는 일은 없습니다.
</Note>

## 예약

<AccordionGroup>
  <Accordion title="/backup interval — 자동 백업" icon="clock">
    | 옵션         | 필수    | 비고                               |
    | ---------- | ----- | -------------------------------- |
    | `mode`     | **예** | `on`, `off` 또는 `status`          |
    | `interval` | 아니요   | 4시간, 8시간, 12시간, 24시간, 2일, 3일, 1주 |
    | `messages` | 아니요   | 0–250. 요금제의 최대치로 제한됩니다           |

    `status`는 현재 일정을 바꾸지 않고 그대로 보여줍니다. 주기, 보관 개수, 마지막 실행과 다음 실행, 그리고 가장 최근 자동 백업의 ID를 알려 줍니다. 일정을 켜면 첫 백업이 언제 실행되는지 알려 줍니다.

    <Note>
      요금제가 허용하는 것보다 짧은 주기는 거부되며, 거부 메시지에 요금제의 최소 주기가 시간 단위로 표시됩니다. 자동 백업은 순환합니다. 새 백업이 만들어지면 요금제가 보관하는 개수를 넘는 가장 오래된 것이 삭제됩니다.
    </Note>
  </Accordion>
</AccordionGroup>

## 채널 백업

<AccordionGroup>
  <Accordion title="/backup channel create — 채널 하나 백업" icon="hashtag">
    | 옵션         | 필수  | 비고                               |
    | ---------- | --- | -------------------------------- |
    | `channel`  | 아니요 | 텍스트, 공지 또는 스레드. 기본값은 현재 채널       |
    | `messages` | 아니요 | 0–1000. 요금제의 최대치로 제한됩니다          |
    | `before`   | 아니요 | 메시지 ID. 그 메시지 **이전**의 메시지를 저장합니다 |

    <Tip>
      `before`는 한 번에 담을 수 있는 것보다 더 이전까지 거슬러 올라가는 방법입니다. 채널 백업을 한 번 만든 다음, 그 백업이 도달한 가장 오래된 메시지 ID를 `before`에 넣고 한 번 더 만드세요.
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — 채널에 다시 게시" icon="paste">
    | 옵션          | 필수    | 비고                      |
    | ----------- | ----- | ----------------------- |
    | `backup_id` | **예** | 채널 백업만 자동완성됩니다          |
    | `channel`   | 아니요   | 게시할 채널. 기본값은 현재 채널      |
    | `messages`  | 아니요   | 0–1000. 요금제의 최대치로 제한됩니다 |

    메시지는 오래된 것부터 고정 상태와 함께 게시됩니다.

    <Note>
      **삭제되는 것은 없습니다.** 저장된 메시지는 채널에 이미 있는 내용 뒤에 추가됩니다. 큰 채널 백업은 시간이 걸리며, 응답이 진행 상황을 계속 알려 줍니다.
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  채널 백업에는 **Basic** 이상이 필요합니다.
</Info>

## 백업 옮기기

<AccordionGroup>
  <Accordion title="/backup export — JSON으로 내려받기" icon="file-export">
    | 옵션          | 필수    | 비고      |
    | ----------- | ----- | ------- |
    | `backup_id` | **예** | 자동완성됩니다 |

    백업을 Discord 형식의 `.json` 파일로 만들어 본인에게만 보이는 응답에 첨부합니다. **8 MB**를 넘으면 파일 대신 대시보드 링크가 제공됩니다.

    <Note>
      내보내기에는 서버, 역할, 채널, 이모지, 스티커가 담깁니다. **메시지, 멤버, 차단은 포함되지 않습니다** — 이 항목들을 옮기려면 백업을 복원하세요. 내보내기는 모든 요금제에서 사용할 수 있습니다.
    </Note>
  </Accordion>

  <Accordion title="/backup import — 파일로 백업 만들기" icon="file-import">
    | 옵션     | 필수    | 비고                                 |
    | ------ | ----- | ---------------------------------- |
    | `file` | **예** | Discord 형식의 서버 `.json` 파일, 최대 5 MB |

    Vetox가 파일을 검증한 뒤 백업으로 변환하고 그 ID를 응답합니다. 다른 백업과 똑같이 복원하거나 살펴볼 수 있습니다.

    <Warning>
      Discord의 서버 형식을 따르지 않는 파일은 실패한 첫 필드를 지목하며 통째로 거부됩니다. Vetox가 파일을 절반만 적용하는 일은 없습니다.
    </Warning>

    <Info>
      가져오기에는 **Basic** 이상이 필요합니다.
    </Info>
  </Accordion>
</AccordionGroup>

## 삭제

<AccordionGroup>
  <Accordion title="/backup delete — 백업 하나 삭제" icon="trash">
    | 옵션          | 필수    | 비고      |
    | ----------- | ----- | ------- |
    | `backup_id` | **예** | 자동완성됩니다 |

    먼저 **확인**을 요구합니다. 삭제하면 스냅샷과 함께 저장된 모든 파일이 즉시, 영구적으로 사라집니다.
  </Accordion>

  <Accordion title="/backup purge — 모든 백업 삭제" icon="dumpster-fire">
    옵션이 없습니다. **확인**을 요구한 뒤 이 서버의 **모든** 백업을 저장된 파일까지 함께 삭제합니다.

    <Warning>
      되돌리기도, 휴지통도 없습니다. 남겨 두고 싶은 것은 먼저 내보내세요.
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  `/backup delete`와 `/backup purge`는 서버의 [권한 단계](/ko/server-management/server-backup#권한)에서 파괴적인 작업에 해당하므로, 기본 단계에서는 소유자만 사용할 수 있습니다.
</Note>

## 예시

```text theme={null}
/backup create name:before-rework
/backup list page:1
/backup list scope:mine
/backup info backup_id:GB7K2QX4M1ZP
/backup load backup_id:GB7K2QX4M1ZP options:!* channels roles
/backup status
/backup interval mode:on interval:12h
/backup channel create channel:#general messages:500
```

## 명령어가 거부될 때

Vetox는 언제나 이유를 알려 줍니다. 자주 보게 되는 것들입니다.

| 응답 내용                                                    | 해결 방법                                                                                                           |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| 최근에 이 서버에서 백업이 생성되었습니다                                   | 서버당 10분인 생성 쿨다운이 끝나기를 기다리세요                                                                                     |
| 다른 백업 작업이 이미 실행 중입니다                                     | 끝나기를 기다리거나 `/backup cancel`을 사용하세요                                                                              |
| 오늘의 복원과 되돌리기 한도에 도달했습니다                                  | 이 서버 또는 본인 계정이 서버당 10회 / 1인당 20회의 하루 한도를 모두 사용했습니다. 내일 다시 시도하세요                                                 |
| 요금제의 백업 한도에 도달했습니다                                       | 하나를 삭제하거나 업그레이드하세요                                                                                              |
| 이 백업은 요금제 한도를 초과합니다                                      | 다운그레이드로 잠긴 상태입니다. 더 최근 백업을 삭제하거나 업그레이드하세요                                                                       |
| 서버의 백업 권한에서 허용한 사람만 이 작업을 할 수 있습니다                       | 이 서버의 권한 단계에서는 이 작업이 소유자에게만 허용됩니다. 소유자가 직접 하거나, 설정 → 권한에서 단계를 바꾸세요                                              |
| 해당 주기는 요금제에서 허용하는 것보다 짧습니다                               | 메시지가 알려 주는 최소 주기를 쓰거나 업그레이드하세요                                                                                  |
| 선택한 옵션 중 유효하지 않은 것이 있습니다                                 | 알 수 없는 `options` 토큰입니다 — 위 문법과 대조해 보세요                                                                          |
| Vetox에 필요한 권한이 없습니다                                      | Vetox에 Administrator를 부여하고 역할을 복원 대상 역할들보다 위로 옮기세요                                                              |
| Discord가 봇에게 허용하는 것은 48시간 동안 역할 250개 또는 채널 500개까지의 생성입니다 | Discord 자체의 생성 한도입니다. `/backup status`가 해제 시각을 알려 줍니다. 기다렸다가 재개하거나, `options:!delete-roles !roles`를 붙여 다시 불러오세요 |
| 이 파일은 유효한 Discord 서버 내보내기 파일이 아닙니다                       | 가져오기 파일이 Discord 형식과 맞지 않습니다                                                                                    |
| 서버 백업을 일시적으로 사용할 수 없습니다                                  | 점검으로 일시 중지되었습니다. 백업은 그대로입니다                                                                                     |

## 관련

<CardGroup cols={2}>
  <Card title="서버 백업" icon="server" href="/ko/server-management/server-backup">
    복원, 일정, 변경 추적, 타임머신까지 기능 전체.
  </Card>

  <Card title="내 백업" icon="box-archive" href="/ko/members/my-backups">
    모든 서버에서 만든 내 백업.
  </Card>

  <Card title="명령어 관리" icon="sliders" href="/ko/server-management/command-management">
    각 서브커맨드를 개별적으로 비활성화하거나 제한합니다.
  </Card>

  <Card title="명령어 레퍼런스" icon="terminal" href="/ko/commands/overview">
    모든 명령어에서 권한과 쿨다운이 어떻게 작동하는지.
  </Card>
</CardGroup>