mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-10-03 12:42:08 +03:00
Egor
a09e136001
* docs: add Discord bot to READMEs, architecture, operations guides, and locales * docs: address review feedback on Discord bot formatting, backup commands, and architecture * docs(discord): fix Persian typo and literal arrows on fa/zh bot pages Senior review of #6513, two LOW findings in the two new pages: - fa/operations/discord-bot.mdx:30 spelled "developers" with Cyrillic "де" in place of Persian "ده", rendering a mixed-script word. - Both pages copied `$\rightarrow$` from the en page. The docs site has no math plugin (nothing in source.config.ts, no remark-math installed), so the built HTML shows the literal string "$\rightarrow$" in every menu path. Replaced with a Unicode arrow on fa and zh; en and ru have carried the same since #6486 and are left for a separate change. --------- Co-authored-by: Sanaei <ho3ein.sanaei@gmail.com>
51 lines
2.3 KiB
Plaintext
51 lines
2.3 KiB
Plaintext
---
|
||
title: 备份与恢复
|
||
description: 手动或通过 Telegram 机器人备份并恢复你的 3x-ui 数据库与证书。
|
||
icon: DatabaseBackup
|
||
---
|
||
|
||
你的全部配置——入站、客户端、各项设置——都存放在面板的数据库中。
|
||
请定期备份，以便日后恢复或迁移。
|
||
|
||
## 需要备份的内容
|
||
|
||
- **数据库** —— 默认为位于 `/etc/x-ui/x-ui.db` 的 SQLite（如果你使用
|
||
PostgreSQL 后端，则为对应的 PostgreSQL 数据库）。
|
||
- **证书** —— `/root/cert/` 下的所有内容（或你存放 TLS 证书的任意位置）。
|
||
|
||
## 手动备份
|
||
|
||
你可以从面板的概览页下载备份，也可以直接从服务器上复制数据库文件：
|
||
|
||
```bash title="copy the SQLite database"
|
||
cp /etc/x-ui/x-ui.db /root/x-ui-backup-$(date +%F).db
|
||
```
|
||
|
||
要恢复时，先停止面板，把数据库文件放回原位，然后重新启动面板。
|
||
|
||
<Callout type="warn">
|
||
尽量将备份恢复到与其来源**相同的主版本**上。跨主版本升级时，应让面板自行
|
||
运行迁移，而不要强行套用旧的数据库结构。
|
||
</Callout>
|
||
|
||
## 机器人自动备份（Telegram 与 Discord）
|
||
|
||
如果你已配置 [Telegram 机器人](/docs/operations/telegram-bot) 或 [Discord 机器人](/docs/operations/discord-bot)，启用 **`tgBotBackup`** 或 **`discordBotBackup`** 即可在周期性报告中附带一份备份（按 `tgRunTime` / `discordRunTime` 计划执行，默认每天一次）。机器人会将**数据库**与 Xray 的 **`config.json`** 一并发送到你的管理员聊天或频道，从而让你始终拥有一份服务器之外的副本。管理员也可以随时从 Telegram 机器人的菜单或使用 Discord 的 `!backup` 命令按需请求备份。
|
||
|
||
## SQLite 转储 / 恢复
|
||
|
||
`x-ui migrate-db` 命令可在 SQLite 数据库与纯文本 SQL 转储之间相互转换
|
||
（便于检查，或在不同机器之间转移）：
|
||
|
||
```bash
|
||
x-ui migrate-db --dump /root/x-ui.sql # SQLite -> SQL text
|
||
x-ui migrate-db --restore /root/x-ui.sql # SQL text -> SQLite
|
||
```
|
||
|
||
若想改用 PostgreSQL，请参阅[数据库](/docs/reference/database)。
|
||
|
||
<Callout type="info">
|
||
无论采用哪种方式，都请将备份保存在**服务器之外**，并不时测试一次恢复——
|
||
未经测试的备份算不上备份。
|
||
</Callout>
|