> ## 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.

# Lệnh sao lưu

> Nhóm lệnh /backup — tạo, liệt kê, xem, khôi phục, lên lịch, xuất, nhập và xóa sạch các bản sao lưu của máy chủ bạn ngay trong Discord.

`/backup` điều khiển [Sao lưu máy chủ](/vi/server-management/server-backup) từ bên trong Discord. Một lệnh, **mười ba lệnh con**.

| Yêu cầu           | Giá trị                                                              |
| ----------------- | -------------------------------------------------------------------- |
| **Bạn cần**       | Manage Server                                                        |
| **Vetox cần**     | View Channel, Read Message History — cùng vài quyền nữa để khôi phục |
| **Thời gian hồi** | 5s                                                                   |
| **Ở đâu**         | Chỉ trong máy chủ. Không dùng được trong DM                          |

<Warning>
  **Mọi phản hồi của `/backup` đều là ephemeral — chỉ mình bạn thấy.** Một ID sao lưu là chìa khóa mở vào nội dung máy chủ của bạn, nên Vetox không bao giờ đăng nó ở nơi các thành viên khác đọc được.
</Warning>

<Note>
  Mỗi lệnh con có thể được tắt riêng hoặc giới hạn theo từng vai trò và từng kênh, qua [Quản lý lệnh](/vi/server-management/command-management). `/backup create` có thể mở cho các quản trị viên của bạn trong khi `/backup load` bị tắt hoàn toàn.
</Note>

## Tạo và xem lại

<AccordionGroup>
  <Accordion title="/backup create — chụp một bản sao lưu" icon="camera">
    | Tùy chọn   | Bắt buộc | Ghi chú                                      |
    | ---------- | -------- | -------------------------------------------- |
    | `name`     | Không    | Tối đa 64 ký tự. Một cái tên giúp dễ tìm lại |
    | `messages` | Không    | 0–250, bị giới hạn ở mức tối đa của gói bạn  |

    Các phần premium được đưa vào tự động, tối đa tới mức gói của bạn cho phép. Phản hồi mang theo ID sao lưu mới rồi cập nhật kèm tiến độ. Khi bản sao lưu xong, phản hồi hiển thị **ID**, hai lệnh dùng với nó (`/backup info` và `/backup load`) và một liên kết tới bản sao lưu trong bảng điều khiển — và trên Starter, còn kèm lời nhắc rằng tin nhắn, dữ liệu thành viên, lệnh cấm và tệp đính kèm đã không được lưu.

    <Note>
      Một bản sao lưu thủ công mỗi máy chủ mỗi **10 phút**, và một tác vụ sao lưu hoặc khôi phục tại một thời điểm. Việc tạo cần quyền Administrator, và ở [mức quyền hạn](/vi/server-management/server-backup#quyền-hạn) **Chỉ chủ sở hữu** thì chỉ riêng chủ sở hữu.
    </Note>
  </Accordion>

  <Accordion title="/backup list — xem các bản sao lưu của bạn" icon="list">
    | Tùy chọn | Bắt buộc | Ghi chú                                                                                                     |
    | -------- | -------- | ----------------------------------------------------------------------------------------------------------- |
    | `page`   | Không    | Từ 1. Hai mươi dòng mỗi trang                                                                               |
    | `scope`  | Không    | **Máy chủ này** (mặc định), **Sao lưu kênh của máy chủ này**, hoặc **Bản sao lưu của tôi trên mọi máy chủ** |

    Mới nhất trước. Bản sao lưu tự động và bản an toàn được đánh dấu để bạn nhận ra ngay. `scope:mine` liệt kê mọi bản sao lưu bạn đã tạo, trên bất kỳ máy chủ nào, kèm máy chủ mà nó đến từ đó — đây là cách tìm ID của một bản sao lưu bạn đã chụp ở nơi khác trước khi tải nó vào đây.
  </Accordion>

  <Accordion title="/backup info — một bản sao lưu chứa những gì" icon="circle-info">
    | Tùy chọn    | Bắt buộc | Ghi chú                  |
    | ----------- | -------- | ------------------------ |
    | `backup_id` | **Có**   | Tự động gợi ý khi bạn gõ |

    Số lượng, các tùy chọn lúc chụp, dung lượng, những kênh sôi động nhất, mọi cảnh báo, liệu nó có bị gói của bạn khóa hay không, và một liên kết tới bản sao lưu trong Trình xem bản chụp của bảng điều khiển — nơi bạn đọc được mọi kênh, vai trò, cài đặt, lệnh cấm và thành viên mà nó chứa.
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id` tự động gợi ý trên mọi lệnh con có nhận nó, nên bạn không bao giờ phải chép tay một ID. Nó chỉ đưa ra những bản sao lưu bạn được phép dùng.
</Tip>

## Khôi phục

<AccordionGroup>
  <Accordion title="/backup load — khôi phục một bản sao lưu" icon="rotate-left">
    | Tùy chọn    | Bắt buộc | Ghi chú                                                      |
    | ----------- | -------- | ------------------------------------------------------------ |
    | `backup_id` | **Có**   | Tự động gợi ý, kể cả các bản sao lưu của bạn từ máy chủ khác |
    | `messages`  | Không    | 0–250, bị giới hạn ở mức tối đa của gói bạn                  |
    | `options`   | Không    | Tối đa 200 ký tự. Xem ngữ pháp bên dưới                      |

    Lần bấm đầu tiên không khôi phục gì cả. Vetox trả lời bằng **bản kế hoạch** — bao nhiêu kênh và vai trò sẽ bị xóa và được tạo, và liệu có vai trò nào nằm trên vai trò của chính Vetox nên không thể đụng tới hay không — sau hai nút **Confirm** và **Cancel** sẽ hết hạn sau **60 giây**. Chỉ khi bạn bấm Confirm thì Vetox mới chụp bản sao an toàn và bắt đầu khôi phục.

    <Warning>
      Tải một bản sao lưu sẽ thay thế kênh và vai trò của máy chủ này. Thành viên không bao giờ bị đá, nhưng mọi thứ được tạo ra sau khi bản sao lưu được chụp sẽ mất.
    </Warning>

    <Note>
      `/backup load` tuân theo [mức quyền hạn](/vi/server-management/server-backup#quyền-hạn) của máy chủ. Với mặc định **Quản trị viên không được thực hiện hành động phá hủy**, bất kỳ ai ngoài chủ sở hữu đều bị từ chối, kể cả khi có Administrator.
    </Note>

    <Note>
      Khôi phục và hoàn tác được phân bổ theo ngày — **10 lần mỗi máy chủ**, **20 lần mỗi người**. `/backup load`, `/backup channel load` và việc hoàn tác một thay đổi đã theo dõi đều tính vào cả hai; tiếp tục một lần khôi phục bị lỗi thì không.
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — dừng tác vụ đang chạy" icon="ban">
    Không có tùy chọn. Hủy tác vụ sao lưu hoặc khôi phục đang chạy của máy chủ này. Điểm kiểm tra vẫn được giữ, nên một lần khôi phục đã hủy vẫn tiếp tục được từ bảng điều khiển.
  </Accordion>

  <Accordion title="/backup status — đang chạy gì, và giới hạn nào đang có hiệu lực" icon="heart-pulse">
    Không có tùy chọn. Hiển thị tác vụ đang chạy trên máy chủ này (loại, giai đoạn, tiến độ, cảnh báo, thời điểm bắt đầu) hoặc cho biết không có gì đang chạy; khi nào tạo được bản sao lưu thủ công tiếp theo nếu thời gian chờ 10 phút đang có hiệu lực; khi nào **giới hạn tạo mới của Discord** được gỡ nếu một lần khôi phục đã chạm phải nó; và khi không có gì đang chạy, vì sao tác vụ gần nhất dừng lại và liệu nó có tiếp tục được từ bảng điều khiển hay không.
  </Accordion>
</AccordionGroup>

### Ngữ pháp của `options`

`options` là một danh sách token cách nhau bằng dấu cách, được áp dụng **từ trái sang phải**.

| Token                                                                                                      | Tác dụng        |
| ---------------------------------------------------------------------------------------------------------- | --------------- |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | **Bật** phần đó |
| `!` đặt trước bất kỳ token nào — `!members`                                                                | **Tắt** phần đó |
| `*`                                                                                                        | Bật **mọi thứ** |
| `!*`                                                                                                       | Tắt **mọi thứ** |

Bỏ hẳn `options` thì Vetox dùng mặc định: **`delete-channels channels delete-roles roles settings`** — một lần thay thế cấu trúc toàn phần, không kèm thành viên, lệnh cấm, tin nhắn ghim, emoji hay sticker.

| Ví dụ                                    | Kết quả                                                                 |
| ---------------------------------------- | ----------------------------------------------------------------------- |
| `options:!* roles delete-roles`          | Chỉ vai trò — xóa các vai trò hiện tại, tạo lại vai trò của bản sao lưu |
| `options:!* channels roles settings`     | Cấu trúc, thêm vào những gì đang có — không có gì bị xóa                |
| `options:* !members !bans`               | Mọi thứ, trừ dữ liệu thành viên và lệnh cấm                             |
| `options:!delete-channels !delete-roles` | Bản mặc định, chuyển thành kiểu bổ sung                                 |

<Warning>
  **Thứ tự có ý nghĩa.** `* !members` bật mọi thứ rồi tắt thành viên. `!members *` tắt thành viên rồi bật lại mọi thứ, kể cả thành viên. Hãy đọc danh sách token của bạn từ trái sang phải.
</Warning>

<Note>
  Token không bao giờ nới rộng được những gì gói của bạn cho phép — giới hạn của gói được áp dụng sau cùng. Một token lạ sẽ bị từ chối kèm tên của nó chứ không bị bỏ qua, nên một lỗi gõ nhầm không bao giờ âm thầm biến mất.
</Note>

## Lên lịch

<AccordionGroup>
  <Accordion title="/backup interval — sao lưu tự động" icon="clock">
    | Tùy chọn   | Bắt buộc | Ghi chú                                              |
    | ---------- | -------- | ---------------------------------------------------- |
    | `mode`     | **Có**   | `on`, `off` hoặc `status`                            |
    | `interval` | Không    | 4 giờ, 8 giờ, 12 giờ, 24 giờ, 2 ngày, 3 ngày, 1 tuần |
    | `messages` | Không    | 0–250, bị giới hạn ở mức tối đa của gói bạn          |

    `status` báo cáo lịch hiện tại mà không thay đổi gì: khoảng thời gian, số bản được giữ, lần chạy gần nhất và lần chạy tiếp theo, cùng ID của bản sao lưu tự động mới nhất. Khi bạn bật lịch, Vetox cho bạn biết bản sao lưu đầu tiên sẽ chạy vào lúc nào.

    <Note>
      Một khoảng ngắn hơn mức gói của bạn cho phép sẽ bị từ chối, và lời từ chối nêu rõ mức tối thiểu của gói bạn tính theo giờ. Bản sao lưu tự động xoay vòng: những bản cũ nhất vượt quá số mà gói của bạn giữ sẽ bị xóa khi có bản mới.
    </Note>
  </Accordion>
</AccordionGroup>

## Sao lưu kênh

<AccordionGroup>
  <Accordion title="/backup channel create — sao lưu một kênh" icon="hashtag">
    | Tùy chọn   | Bắt buộc | Ghi chú                                                        |
    | ---------- | -------- | -------------------------------------------------------------- |
    | `channel`  | Không    | Kênh văn bản, thông báo hoặc thread. Mặc định là kênh hiện tại |
    | `messages` | Không    | 0–1000, bị giới hạn ở mức tối đa của gói bạn                   |
    | `before`   | Không    | Một ID tin nhắn. Lưu những tin nhắn **trước** nó               |

    <Tip>
      `before` là cách để đi ngược xa hơn mức một lần chạy cho phép: chụp một bản sao lưu kênh, rồi chụp bản nữa với `before` đặt bằng ID tin nhắn cũ nhất mà bản đầu tiên chạm tới.
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — đăng chúng vào một kênh" icon="paste">
    | Tùy chọn    | Bắt buộc | Ghi chú                                      |
    | ----------- | -------- | -------------------------------------------- |
    | `backup_id` | **Có**   | Chỉ tự động gợi ý các bản sao lưu kênh       |
    | `channel`   | Không    | Nơi cần đăng. Mặc định là kênh hiện tại      |
    | `messages`  | Không    | 0–1000, bị giới hạn ở mức tối đa của gói bạn |

    Tin nhắn được đăng theo thứ tự cũ nhất trước, kèm phần ghim của chúng.

    <Note>
      **Không có gì bị xóa.** Các tin nhắn đã lưu được thêm vào bên cạnh những gì đã có trong kênh. Một bản sao lưu kênh lớn cần một lúc — phản hồi báo tiến độ trong khi chạy.
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  Sao lưu kênh cần **Basic** trở lên.
</Info>

## Di chuyển bản sao lưu

<AccordionGroup>
  <Accordion title="/backup export — tải về dưới dạng JSON" icon="file-export">
    | Tùy chọn    | Bắt buộc | Ghi chú       |
    | ----------- | -------- | ------------- |
    | `backup_id` | **Có**   | Tự động gợi ý |

    Gửi bản sao lưu dưới dạng tệp `.json` theo định dạng Discord, đính kèm vào phản hồi ephemeral. Trên **8 MB** thì bạn nhận được một liên kết tới bảng điều khiển thay thế.

    <Note>
      Bản xuất mang theo máy chủ, vai trò, kênh, emoji và sticker. **Tin nhắn, thành viên và lệnh cấm không được đưa vào** — hãy khôi phục bản sao lưu để chuyển những thứ đó. Xuất hoạt động trên mọi gói.
    </Note>
  </Accordion>

  <Accordion title="/backup import — dựng một bản sao lưu từ tệp" icon="file-import">
    | Tùy chọn | Bắt buộc | Ghi chú                                                     |
    | -------- | -------- | ----------------------------------------------------------- |
    | `file`   | **Có**   | Một tệp `.json` máy chủ theo định dạng Discord, tối đa 5 MB |

    Vetox xác thực tệp, biến nó thành một bản sao lưu và trả lời kèm ID của bản đó. Hãy khôi phục hoặc xem nó như mọi bản khác.

    <Warning>
      Một tệp không tuân theo định dạng máy chủ của Discord sẽ bị từ chối hoàn toàn và nêu tên trường đầu tiên bị lỗi. Vetox không bao giờ áp dụng nửa vời.
    </Warning>

    <Info>
      Nhập cần **Basic** trở lên.
    </Info>
  </Accordion>
</AccordionGroup>

## Xóa

<AccordionGroup>
  <Accordion title="/backup delete — xóa một bản sao lưu" icon="trash">
    | Tùy chọn    | Bắt buộc | Ghi chú       |
    | ----------- | -------- | ------------- |
    | `backup_id` | **Có**   | Tự động gợi ý |

    Yêu cầu bấm **Confirm** trước. Việc xóa gỡ bỏ bản chụp và mọi tệp được lưu cùng nó, ngay lập tức và vĩnh viễn.
  </Accordion>

  <Accordion title="/backup purge — xóa mọi bản sao lưu" icon="dumpster-fire">
    Không có tùy chọn. Yêu cầu bấm **Confirm**, rồi xóa **mọi** bản sao lưu của máy chủ này cùng các tệp được lưu kèm.

    <Warning>
      Không có hoàn tác và không có thùng rác. Hãy xuất trước những gì bạn muốn giữ.
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  `/backup delete` và `/backup purge` là những hành động phá hủy theo [mức quyền hạn](/vi/server-management/server-backup#quyền-hạn) của máy chủ, nên ở mức mặc định thì chúng chỉ dành riêng cho chủ sở hữu.
</Note>

## Ví dụ

```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
```

## Khi một lệnh bị từ chối

Vetox luôn nêu rõ lý do. Những trường hợp thường gặp:

| Phản hồi nói gì                                                                   | Cần làm gì                                                                                                                                              |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Vừa có một bản sao lưu được tạo ở đây                                             | Chờ hết thời gian chờ tạo 10 phút của mỗi máy chủ                                                                                                       |
| Một tác vụ sao lưu khác đang chạy                                                 | Chờ nó xong, hoặc dùng `/backup cancel`                                                                                                                 |
| Đã đạt giới hạn khôi phục và hoàn tác của hôm nay                                 | Máy chủ này hoặc tài khoản của bạn đã dùng hết hạn mức ngày là 10 lần mỗi máy chủ / 20 lần mỗi người. Hãy thử lại vào ngày mai                          |
| Bạn đã đạt giới hạn số bản sao lưu của gói                                        | Xóa bớt một bản, hoặc nâng cấp                                                                                                                          |
| Bản sao lưu này vượt quá giới hạn của gói bạn                                     | Nó bị khóa do một lần hạ cấp. Xóa một bản mới hơn hoặc nâng cấp                                                                                         |
| Chỉ những người được quyền hạn sao lưu của máy chủ cho phép mới làm được việc này | Mức quyền hạn của máy chủ dành việc này cho chủ sở hữu. Chủ sở hữu tự làm, hoặc đổi mức đó tại Cài đặt → Quyền hạn                                      |
| Khoảng đó ngắn hơn mức gói của bạn cho phép                                       | Dùng mức tối thiểu mà thông báo nêu ra, hoặc nâng cấp                                                                                                   |
| Một trong các tùy chọn đã chọn không hợp lệ                                       | Một token `options` lạ — hãy đối chiếu với phần ngữ pháp ở trên                                                                                         |
| Vetox thiếu những quyền mà nó cần                                                 | Cấp cho Vetox quyền Administrator và chuyển vai trò của nó lên trên những vai trò đang được khôi phục                                                   |
| Discord chỉ cho phép một bot tạo 250 vai trò hoặc 500 kênh trong vòng 48 giờ      | Giới hạn tạo mới của chính Discord. `/backup status` cho biết khi nào nó được gỡ; hãy chờ rồi tiếp tục, hoặc tải lại với `options:!delete-roles !roles` |
| Tệp đó không phải bản xuất máy chủ Discord hợp lệ                                 | Tệp nhập không khớp định dạng của Discord                                                                                                               |
| Sao lưu máy chủ tạm thời không khả dụng                                           | Đang tạm dừng để bảo trì. Các bản sao lưu của bạn không bị đụng tới                                                                                     |

## Liên quan

<CardGroup cols={2}>
  <Card title="Sao lưu máy chủ" icon="server" href="/vi/server-management/server-backup">
    Toàn bộ tính năng — khôi phục, lịch tự động, theo dõi thay đổi và Time Machine.
  </Card>

  <Card title="Sao lưu của tôi" icon="box-archive" href="/vi/members/my-backups">
    Bản sao lưu của bạn trên mọi máy chủ.
  </Card>

  <Card title="Quản lý lệnh" icon="sliders" href="/vi/server-management/command-management">
    Tắt hoặc giới hạn từng lệnh con một cách riêng lẻ.
  </Card>

  <Card title="Tài liệu tham khảo lệnh" icon="terminal" href="/vi/commands/overview">
    Cách quyền và thời gian hồi hoạt động trên tất cả các lệnh.
  </Card>
</CardGroup>
