> ## 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 内部操作[服务器备份](/zh-CN/server-management/server-backup)。一个命令，**十三个子命令**。

| 要求           | 值                       |
| ------------ | ----------------------- |
| **您需要**      | 管理服务器                   |
| **Vetox 需要** | 查看频道、阅读消息历史 —— 恢复时还需要更多 |
| **冷却**       | 5 秒                     |
| **适用范围**     | 仅限服务器。在私信中不可用           |

<Warning>
  **每一条 `/backup` 回复都是临时消息 —— 只有您能看到。** 备份 ID 是通往服务器内容的钥匙，因此 Vetox 绝不会把它发到其他成员能读到的地方。
</Warning>

<Note>
  每个子命令都可以通过[命令管理](/zh-CN/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 分钟** 只能创建一个手动备份，并且同一时间只能有一个备份或恢复任务。创建需要管理员权限；在 **只有所有者** 的[权限级别](/zh-CN/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` 遵循服务器的[权限级别](/zh-CN/server-management/server-backup#权限)。在默认的 **管理员不能执行破坏性操作** 之下，除所有者以外的任何人即使拥有管理员权限也会被拒绝。
    </Note>

    <Note>
      恢复和还原每天都有配额 —— **每个服务器 10 次**、**每人 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` 就是您回溯到比一次运行更早位置的办法：先做一次频道备份，然后再做一次，把 `before` 设为第一次所到达的最旧消息 ID。
    </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>
  按服务器的[权限级别](/zh-CN/server-management/server-backup#权限)，`/backup delete` 和 `/backup purge` 属于破坏性操作，因此在默认级别下，它们专属于所有者。
</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 次 / 每人 20 次。请明天重试                                             |
| 已达到方案的备份上限                                 | 删除一个，或升级方案                                                                               |
| 此备份超出了当前方案的上限                              | 它因降级而被锁定。删除一个较新的备份，或升级方案                                                                 |
| 只有该服务器备份权限允许的人才能执行此操作                      | 该服务器的权限级别把这件事留给了所有者。由所有者操作，或在“设置 → 权限”中更改该级别                                             |
| 该间隔短于方案允许的时长                               | 使用提示中写明的最短间隔，或升级方案                                                                       |
| 所选选项中有一项无效                                 | `options` 中有无法识别的关键词 —— 请对照上文的语法检查                                                       |
| Vetox 缺少所需的权限                              | 给 Vetox 管理员权限，并把它的身份组移到被恢复的身份组之上                                                         |
| Discord 只允许机器人在 48 小时内创建 250 个身份组或 500 个频道 | Discord 自己的创建上限。`/backup status` 会显示它何时解除；请等待后继续，或改用 `options:!delete-roles !roles` 重新加载 |
| 该文件不是有效的 Discord 服务器导出文件                   | 导入的文件不符合 Discord 的格式                                                                     |
| 服务器备份暂时不可用                                 | 已暂停以进行维护。您的备份未受影响                                                                        |

## 相关

<CardGroup cols={2}>
  <Card title="服务器备份" icon="server" href="/zh-CN/server-management/server-backup">
    完整功能 —— 恢复、计划、变更跟踪和时光机。
  </Card>

  <Card title="我的备份" icon="box-archive" href="/zh-CN/members/my-backups">
    您在所有服务器中的备份。
  </Card>

  <Card title="命令管理" icon="sliders" href="/zh-CN/server-management/command-management">
    单独禁用或限制每一个子命令。
  </Card>

  <Card title="命令参考" icon="terminal" href="/zh-CN/commands/overview">
    权限和冷却在所有命令中如何运作。
  </Card>
</CardGroup>