# 配置系统架构

## 1. 身份识别

- **定义**：一个灵活、层次清晰的 YAML 配置系统，支持细粒度的备份策略定制
- **目的**：通过声明式配置，控制 Docker 备份的各个方面

## 2. 核心组件

- `/etc/docker-backup/config.yml`: 系统配置文件（安装时从 `config/backup.yml.example` 创建）
- `bin/backup.sh`: 读取并解析配置的主脚本
- `yq`: 用于 YAML 配置解析的关键工具

## 3. 执行流程（LLM 检索图）

1. **配置加载**：
   - 读取 `/etc/docker-backup/config.yml`
   - 使用 `yq` 解析配置项

2. **依赖性验证**：
   - 检查必要工具（`yq`, `tar`, `docker`）
   - 验证配置文件有效性
   - 校验备份源和容器可用性

3. **配置解析**：
   - 提取备份基础配置 (`backup`)
   - 处理文件夹备份设置 (`folders`)
   - 解析 MySQL 备份参数 (`mysql`)
   - 配置日志和通知 (`logging`, `notification`)

## 4. 设计原理

- **灵活性**：通过 YAML 配置提供高度可定制的备份策略
- **最小侵入**：仅依赖常见的 Unix 工具链
- **安全性**：配置项有严格的验证机制