152 lines
3.8 KiB
Markdown
152 lines
3.8 KiB
Markdown
# 管理系统目录结构
|
||
|
||
## 🏗️ 目录组织
|
||
这个目录用于组织和管理不同类型的系统管理工具和配置。
|
||
|
||
## 📁 目录结构
|
||
```
|
||
managed-systems/
|
||
├── README.md # 本文件
|
||
├── docker-management/ # Docker容器管理
|
||
│ ├── docker-apps.yaml # 应用映射配置
|
||
│ ├── docker-config-editor.sh # 配置编辑工具
|
||
│ ├── DOCKER_CONFIG_EDITOR_GUIDE.md # 配置编辑指南
|
||
│ └── docker-command-processor.md # 自然语言指令处理器
|
||
├── ssh-management/ # SSH连接管理（预留）
|
||
├── monitoring-management/ # 监控系统管理（预留）
|
||
└── documentation/ # 文档和指南（预留）
|
||
```
|
||
|
||
## 🎯 设计理念
|
||
|
||
### 1. 模块化组织
|
||
- 每个系统类型有独立的目录
|
||
- 相关工具和配置放在一起
|
||
- 便于扩展和维护
|
||
|
||
### 2. 清晰的命名
|
||
- 目录名：`[系统类型]-management`
|
||
- 文件名：描述性名称，易于理解
|
||
- 扩展名：表明文件类型和用途
|
||
|
||
### 3. 可扩展性
|
||
- 预留目录用于未来扩展
|
||
- 标准化的文件结构
|
||
- 易于添加新的管理系统
|
||
|
||
## 🚀 当前实现
|
||
|
||
### Docker管理系统
|
||
**位置**: `docker-management/`
|
||
|
||
**功能**:
|
||
1. **应用发现和映射** (`docker-apps.yaml`)
|
||
- 记录所有服务器上的Docker应用
|
||
- 包含路径、服务器、描述信息
|
||
|
||
2. **配置编辑工具** (`docker-config-editor.sh`)
|
||
- 安全地编辑docker-compose.yml文件
|
||
- 自动备份和验证
|
||
- 支持查看、备份、验证、重启操作
|
||
|
||
3. **使用指南** (`DOCKER_CONFIG_EDITOR_GUIDE.md`)
|
||
- 详细的工作流程说明
|
||
- 安全编辑步骤
|
||
- 故障排除指南
|
||
|
||
4. **自然语言接口** (`docker-command-processor.md`)
|
||
- 理解自然语言指令
|
||
- 映射到具体命令执行
|
||
|
||
## 🔄 工作流程
|
||
|
||
### Docker管理流程
|
||
```
|
||
1. 指令解析 → 2. 配置查找 → 3. 命令执行 → 4. 结果反馈
|
||
```
|
||
|
||
### 安全编辑流程
|
||
```
|
||
1. 查看当前配置 → 2. 创建备份 → 3. 编辑文件 → 4. 验证格式 → 5. 重启应用
|
||
```
|
||
|
||
## 📋 服务器配置
|
||
|
||
### 服务器路径映射
|
||
| 服务器 | Docker路径 | 应用示例 |
|
||
|--------|------------|----------|
|
||
| ubuntu1 | `/home/shenwei/Docker/` | portainer, rsshub, it-tools |
|
||
| ubuntu2 | `/home/shenwei/docker/` | cloudflared, uptime-kuma |
|
||
| NAS | `/volume1/docker/` | navidrome, mysql80 |
|
||
|
||
### 应用统计
|
||
- **总服务器**: 3台
|
||
- **总应用**: 16个
|
||
- **最后扫描**: 2026-03-13
|
||
|
||
## 🔮 未来扩展
|
||
|
||
### 计划中的管理系统
|
||
1. **SSH管理系统**
|
||
- SSH连接配置管理
|
||
- 密钥管理和轮换
|
||
- 连接测试和监控
|
||
|
||
2. **监控管理系统**
|
||
- Prometheus配置管理
|
||
- Grafana仪表板管理
|
||
- 告警规则配置
|
||
|
||
3. **备份管理系统**
|
||
- 备份策略配置
|
||
- 备份计划管理
|
||
- 恢复测试流程
|
||
|
||
### 通用模式
|
||
每个管理系统遵循相似的模式：
|
||
1. 配置发现和映射
|
||
2. 安全操作工具
|
||
3. 使用指南文档
|
||
4. 自然语言接口
|
||
|
||
## 📝 维护指南
|
||
|
||
### 添加新系统
|
||
1. 创建新目录：`[系统名]-management/`
|
||
2. 添加配置文件、工具、文档
|
||
3. 更新本README文件
|
||
4. 测试功能完整性
|
||
|
||
### 更新现有系统
|
||
1. 在相应目录中更新文件
|
||
2. 更新版本和日期信息
|
||
3. 测试向后兼容性
|
||
4. 更新相关文档
|
||
|
||
### 备份策略
|
||
- 重要配置文件定期备份
|
||
- 工具脚本版本控制
|
||
- 文档更新记录
|
||
|
||
## 🏆 最佳实践
|
||
|
||
### 文件命名
|
||
- 使用小写字母和连字符
|
||
- 描述性文件名
|
||
- 一致的扩展名
|
||
|
||
### 文档标准
|
||
- 每个目录有README文件
|
||
- 工具脚本有使用说明
|
||
- 配置文件有注释说明
|
||
|
||
### 安全考虑
|
||
- 敏感信息不存储在配置文件中
|
||
- 操作前备份重要文件
|
||
- 验证操作结果
|
||
|
||
## 📊 版本信息
|
||
- **创建时间**: 2026-03-13
|
||
- **最后更新**: 2026-03-13
|
||
- **版本**: 1.0.0
|
||
- **维护者**: 星曜 (OpenClaw助手) |