secubox-openwrt/package/secubox/secubox-app-backup/README.zh.md
CyberMind-FR ccfb58124c docs: Add trilingual documentation (French and Chinese translations)
Add complete French (fr) and Chinese (zh) translations for all documentation:

- Root files: README, CHANGELOG, SECURITY, BETA-RELEASE
- docs/: All 16 core documentation files
- DOCS/: All 19 deep-dive documents including embedded/ and archive/
- package/secubox/: All 123+ package READMEs
- Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/

Total: 346 translation files created

Each file includes language switcher links for easy navigation between
English, French, and Chinese versions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-03-20 10:00:18 +01:00

133 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[English](README.md) | [Francais](README.fr.md) | 中文
# SecuBox 备份管理器
统一的备份系统,用于 LXC 容器、UCI 配置、服务数据和配置文件,支持 mesh 同步。
## 安装
```bash
opkg install secubox-app-backup
```
## CLI 使用
### 创建备份
```bash
# 完整备份(配置 + 容器 + 服务)
secubox-backup create --full
# 仅配置UCI、证书
secubox-backup create --config
# 仅容器LXC
secubox-backup create --containers
# 仅服务HAProxy、mitmproxy 数据)
secubox-backup create --services
```
### 列出备份
```bash
secubox-backup list # 所有备份
secubox-backup list --local # 仅本地
secubox-backup list --remote # 仅 Gitea 远程
```
### 恢复
```bash
secubox-backup restore config-20260205-120000.tar.gz
secubox-backup restore config-20260205-120000.tar.gz --dry-run
```
### 容器管理
```bash
secubox-backup container list # 列出 LXC 容器
secubox-backup container backup mitmproxy # 备份特定容器
secubox-backup container restore mitmproxy /path/to/backup.tar.gz
secubox-backup container backups mitmproxy # 列出容器的备份
```
### 配置文件管理
```bash
secubox-backup profile list # 列出配置文件
secubox-backup profile create mysetup # 从当前配置创建
secubox-backup profile apply mysetup # 应用配置文件
```
### 远程同步Gitea
```bash
secubox-backup sync --push # 推送到 Gitea
secubox-backup sync --pull # 列出远程备份
```
### 维护
```bash
secubox-backup status # 显示备份状态
secubox-backup cleanup # 删除旧备份(保留最近 10 个)
```
## UCI 配置
```
config backup 'main'
option enabled '1'
option storage_path '/srv/backups'
option retention_days '30'
option max_backups '10'
option compress '1'
config schedule 'daily'
option enabled '1'
option type 'config'
option cron '0 3 * * *'
config schedule 'weekly'
option enabled '1'
option type 'full'
option cron '0 4 * * 0'
config remote 'gitea'
option enabled '1'
option url 'https://git.example.com'
option repo 'user/backups'
option token '您的令牌'
option branch 'master'
```
## 备份结构
```
/srv/backups/
+-- config/ # UCI 和证书备份
| +-- config-YYYYMMDD-HHMMSS.tar.gz
+-- containers/ # LXC 容器备份
| +-- mitmproxy-YYYYMMDD-HHMMSS.tar.gz
| +-- haproxy-YYYYMMDD-HHMMSS.tar.gz
+-- services/ # 服务数据备份
| +-- haproxy-YYYYMMDD-HHMMSS.tar.gz
+-- profiles/ # 配置文件
+-- mysetup.json
```
## 备份内容
| 类型 | 内容 |
|------|------|
| **配置** | `/etc/config/*`、`/etc/secubox/*`、`/etc/haproxy/*`、`/srv/haproxy/certs/*`、`/etc/acme/*` |
| **容器** | 来自 `/srv/lxc/<名称>/` 的完整 LXC rootfs |
| **服务** | `/srv/haproxy/`、`/srv/mitmproxy/`、`/srv/localai/`、`/srv/gitea/` |
## 依赖项
- `lxc` - 用于容器备份/恢复
- `tar` - 存档创建
- `wget` - Gitea API 通信(可选)