From 816336fe06b351d407512c9e64934c2da67ed101 Mon Sep 17 00:00:00 2001 From: Cat Tom Date: Thu, 26 Mar 2026 16:59:39 +0800 Subject: [PATCH] Add Backrest.md --- docs/tech/Backrest.md | 122 ++++++++++++++++++ ...-of-Docker-Volumes-A-Step-by-Step-Guide.md | 2 +- docs/tech/HC5661.md | 2 +- docs/tech/Mi8UD(equuleus).md | 2 +- .../Proxmox-9-Install-and-Configuration.md | 2 +- ...xmox-Backup-4-Install-and-Configuration.md | 6 +- mkdocs.yml | 1 + 7 files changed, 128 insertions(+), 9 deletions(-) create mode 100644 docs/tech/Backrest.md diff --git a/docs/tech/Backrest.md b/docs/tech/Backrest.md new file mode 100644 index 0000000..f54652a --- /dev/null +++ b/docs/tech/Backrest.md @@ -0,0 +1,122 @@ +# Backrest: 备份新选择 + +## 环境 + +- Ubuntu 24.04 LTS +- Docker & Docker Compose + +## 安装 + +``` bash +mkdir ~/backrest && cd ~/backrest + +touch docker-compose.yml && nano docker-compose.yml +``` + +请按照实际情况修改 `docker-compose.yml` 中的相关部分。 + +``` yaml title="docker-compose.yml" +services: + backrest: + image: garethgeorge/backrest:latest + container_name: backrest + hostname: your-server-name + ports: + - "9898:9898" + volumes: + # Backrest data + - /path/to/backrest/data:/data + - /path/to/backrest/config:/config + - /path/to/backrest/cache:/cache + - /path/to/backrest/tmp:/tmp + # Rclone config + - /path/to/backrest/rclone:/root/.config/rclone + # Data backup path + - /path/to/immich-app:/backup/immich-app:ro + # Data restore path + - /path/to/backrest/restore:/restore + environment: + BACKREST_DATA: /data + BACKREST_CONFIG: /config/config.json + XDG_CACHE_HOME: /cache + TMPDIR: /tmp + TZ: "Asia/Shanghai" + restart: unless-stopped +``` + +``` bash +sudo docker compose up -d +``` + +## 配置 + +用浏览器打开 `http://your-server-ip:9898`，首次启动需要配置服务器名称和管理员账号密码。 + +填写 Cron 表达式时可以参考[这个网站](https://crontab.guru/)。 + +### 仓库 + +- **仓库名称**: 名称中只能包含数字和字母，以及短横线 - 或下划线 _ ，创建后不可更改。 +- **仓库 URI** + - 本地: `/path/to/your/storage`，绝对路径，需要在 `docker-compose.yml` 的 `volumes` 段填写映射路径。 + - 阿里云 OSS: `s3:https://oss-[Region ID].aliyuncs.com/[Bucket Name]` +- **密码**: 建议密码熵值至少为 128 位（20 个字符或更长）。点击 `生成` 以使用浏览器的加密随机 API 生成一个随机密码。**妥善保存该密码！** +- **环境变量**(阿里云 OSS) + - [获取 AccessKey](https://ram.console.aliyun.com/users) + - `AWS_ACCESS_KEY_ID=[your-AccessKey-id]` + - `AWS_SECRET_ACCESS_KEY=[your-AccessKey-secret]` +- **选项**(阿里云 OSS) + - `-o s3.bucket-lookup=dns` + - `-o s3.region=[Region ID]` + - `--limit-upload 1800` (上传限速，单位为 KiB/s) +- **清理策略** + - **清理后最大未引用数据占比**: `10` + - **调度类型**: `Cron` + - **Cron 表达式**: `0 8 * * 3` (每周三早上8点) + - **参考时钟**: `本地` +- **检查策略** + - **读取数据百分比**: `10` + - **调度类型**: `Cron` + - **Cron 表达式**: `0 8 * * 4` (每周四早上8点) + - **参考时钟**: `本地` + +### 调度计划 + +- **调度计划名称**: 名称中只能包含数字和字母，以及短横线 - 或下划线 _ ，创建后不可更改。 +- **路径**: `/path/to/your/data`，绝对路径，需要在 `docker-compose.yml` 的 `volumes` 段填写映射路径。 +- **备份调度** + - **调度类型**: `Cron` + - **Cron 表达式**: `0 6 * * *` (每天早上6点) + - **参考时钟**: `本地` +- **保留策略**: `按计数` + - **保留最近的N个快照**: `7` + +## 恢复数据 + +以下讨论设备正常运行时恢复部分数据，和设备重置后从零恢复数据两种情况。 + +### 部分数据恢复 + +点击数据所在的调度计划，找到希望恢复的对应时间点的备份，在“快照”处打开“快照浏览器”。 + +点击希望恢复的文件夹/文件的右侧选项，点击 `Restore to path`。 + +`Restore to path`: `/restore/[backrest-generate]` + +恢复的数据会存放在 `/path/to/backrest/restore/[backrest-generate]` 内。 + +### 从零恢复数据 + +参照上述流程重新安装 Backrest。 + +参照上述流程重新配置仓库，**仓库 URI**、**密码**、**环境变量**(阿里云 OSS)和**选项**(阿里云 OSS)等务必与此前配置一致。 + +在对应仓库界面内，点击 `索引快照`。快照完成索引后，将按创建时间顺序以树状视图显示在 Backrest 中。 + +接下来，可参照部分数据恢复的流程恢复需要的数据。 + +## 参考 + +[Restore Files | Backrest](https://garethgeorge.github.io/backrest/introduction/restore-files) + +[Backrest：自建备份方案的一种可能 - 初之音](https://www.himiku.com/archives/backrest.html) \ No newline at end of file diff --git a/docs/tech/Backup-and-Restore-of-Docker-Volumes-A-Step-by-Step-Guide.md b/docs/tech/Backup-and-Restore-of-Docker-Volumes-A-Step-by-Step-Guide.md index c291ec5..2af9e38 100644 --- a/docs/tech/Backup-and-Restore-of-Docker-Volumes-A-Step-by-Step-Guide.md +++ b/docs/tech/Backup-and-Restore-of-Docker-Volumes-A-Step-by-Step-Guide.md @@ -88,4 +88,4 @@ tar -xzvf /backup/3-buyvm-lv_grafana-storage.tar.gz -C / ## 参考 -[Backup and Restore of Docker Volumes: A Step-by-Step Guide](https://osmosys.co/blog/backup-and-restore-of-docker-volumes-a-step-by-step-guide/) \ No newline at end of file +[Backup and Restore of Docker Volumes: A Step-by-Step Guide OSMOSYS](https://osmosys.co/blog/backup-and-restore-of-docker-volumes-a-step-by-step-guide/) \ No newline at end of file diff --git a/docs/tech/HC5661.md b/docs/tech/HC5661.md index b0a721f..559136b 100644 --- a/docs/tech/HC5661.md +++ b/docs/tech/HC5661.md @@ -42,4 +42,4 @@ ## 参考 -[极1s(hc5661)刷 padavan 固件全纪录](https://www.3kjs.com/topic/10014.html) +[极路由极1s hc5661 刷padavan固件全纪录 - 科技师](https://www.3kjs.com/topic/10014.html) diff --git a/docs/tech/Mi8UD(equuleus).md b/docs/tech/Mi8UD(equuleus).md index af16852..967771d 100644 --- a/docs/tech/Mi8UD(equuleus).md +++ b/docs/tech/Mi8UD(equuleus).md @@ -84,7 +84,7 @@ ## 参考 -[Install LineageOS on Xiaomi Mi 8 Pro](https://wiki.lineageos.org/devices/equuleus/install) +[Install LineageOS on equuleus | LineageOS Wiki](https://wiki.lineageos.org/devices/equuleus/install) diff --git a/docs/tech/Proxmox-9-Install-and-Configuration.md b/docs/tech/Proxmox-9-Install-and-Configuration.md index 2fe5065..08a5e4d 100644 --- a/docs/tech/Proxmox-9-Install-and-Configuration.md +++ b/docs/tech/Proxmox-9-Install-and-Configuration.md @@ -237,4 +237,4 @@ lvextend -l +100%FREE /dev/pve/data [Proxmox Beginner’s Guide: Everything You Need to Get Started - YouTube](https://www.youtube.com/watch?v=lFzWDJcRsqo) -[What are these 100.x.y.z addresses?](https://tailscale.com/docs/concepts/tailscale-ip-addresses) \ No newline at end of file +[What are these 100.x.y.z addresses? · Tailscale Docs](https://tailscale.com/docs/concepts/tailscale-ip-addresses) \ No newline at end of file diff --git a/docs/tech/Proxmox-Backup-4-Install-and-Configuration.md b/docs/tech/Proxmox-Backup-4-Install-and-Configuration.md index 40cd8ea..e0037b2 100644 --- a/docs/tech/Proxmox-Backup-4-Install-and-Configuration.md +++ b/docs/tech/Proxmox-Backup-4-Install-and-Configuration.md @@ -135,8 +135,4 @@ sudo echo "[host_ip]:[/path/on/host] /mnt/nas nfs auto,nofail,noatime,nolock,int ## 参考 -[Storage - Proxmox VE](https://pve.proxmox.com/wiki/Storage) - -[Proxmox VE Storage](https://proxmox.homelab.cattom.site/pve-docs/chapter-pvesm.html) - -[QEMU/KVM Virtual Machines](https://proxmox.homelab.cattom.site/pve-docs/chapter-qm.html) \ No newline at end of file +[Storage - Proxmox VE](https://pve.proxmox.com/wiki/Storage) \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 56557b0..40b6d42 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -99,6 +99,7 @@ nav: - "Redmi 4X (santoni)": tech/Redmi4X(santoni).md - "2026年3月18日事故": tech/2026-3-18.md - "定制 Debian 13 镜像": tech/Customize-Debian-13-Image.md + - "Backrest: 备份新选择": tech/Backrest.md - "安装和配置 Proxmox 9": tech/Proxmox-9-Install-and-Configuration.md - "PicoKeys: YubiKey 的开源平替": tech/Picokeys.md - "手把手教你备份和还原 Docker 卷": tech/Backup-and-Restore-of-Docker-Volumes-A-Step-by-Step-Guide.md