# easy

**Repository Path**: lzailai/easy

## Basic Information

- **Project Name**: easy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-11
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 运维管理系统

## 项目概述

运维管理系统，提供全面的服务器管理、监控、告警和自动化运维解决方案。系统采用前后端分离架构，支持大规模集群管理和自动化部署。

## 系统架构

### 核心服务模块

- **easy-web**: 前端Web应用，基于Vue 3 + TypeScript + Ant Design Vue构建
- **easy-service**: 后端服务层，基于Go语言开发，提供RESTful API
- **easy-agent**: 数据采集代理组件，负责服务器监控数据收集
- **easy-alarm**: 告警和通知服务，支持多种告警渠道


## 功能特性

### 🖥️ 资产管理
- 主机分组管理
- 密钥和身份认证管理
- 授权权限控制
- 资产信息统计

### 🖥️ 在线终端
- 多协议支持（SSH、RDP、VNC）
- 在线终端访问
- 自定义快捷键配置
- 主题风格切换

### 📁 文件管理
- SFTP文件传输
- 批量上传/下载
- 在线文件编辑
- 文件分发管理

### ⚡ 批量操作
- 批量命令执行
- 多主机并行管理
- 执行日志记录
- 操作结果统计

### ⏰ 计划任务
- Cron表达式配置
- 定时任务管理
- 执行历史查看
- 任务状态监控

### 📊 监控告警
- 实时性能监控
- 自定义告警规则
- 多渠道告警通知
- 告警历史管理


## 技术栈

### 前端技术
- **框架**: Vue 3 + TypeScript
- **UI库**: Ant Design Vue 4.x
- **构建工具**: Vite
- **状态管理**: Pinia
- **路由**: Vue Router
- **HTTP客户端**: Axios

### 后端技术
- **语言**: Go 1.19+
- **框架**: Gin
- **数据库**: sqlite


## 项目结构

```
easy/
├── easy-web/                 # 前端WEB服务
├── easy-service/             # 后端API服务
├── easy-agent/               # 数据采集代理
├── easy-alarm/               # 告警服务
└── readme.md                 # 项目说明文档
```

## 快速开始

### 环境要求

- Node.js 16+
- Go 1.19+

### 安装部署

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd easy
   ```

2. **配置环境**
   ```bash
   cd easy-shell
   ./bin/easy.sh
   # 选择 "1) 参数配置管理" 进行环境配置
   ```

3. **启动服务**
   ```bash
   # 启动后端服务
   cd easy-service
   go run cmd/server/main.go
   
   # 启动前端服务
   cd easy-web
   npm install
   npm run dev
   ```

4. **访问系统**
   - 前端地址: http://localhost:1025
   - 后端API: http://localhost:11025
   - 默认账号: admin / 123456

## 开发指南

### 代码规范
- 遵循各模块的编码标准（详见 `designdoc/` 目录）
- 使用统一的Git提交规范
- 代码评审必须通过才能合并

### 分支策略
- `master`: 生产环境代码
- `develop`: 开发环境代码
- `feature/*`: 功能开发分支
- `hotfix/*`: 紧急修复分支

### 测试要求
- 单元测试覆盖率 > 80%
- 集成测试覆盖核心功能
- 端到端测试覆盖关键流程

## 部署说明

### Docker部署
```bash
# 构建镜像
docker build -t easy-web ./easy-web
docker build -t easy-service ./easy-service

# 运行容器
docker-compose up -d
```


## 监控告警

### 系统监控
- CPU使用率告警阈值: 80%
- 内存使用率告警阈值: 80%
- 磁盘空间告警阈值: 80%
- 网络负载告警阈值: 80%

### 告警渠道
- 邮件通知
- 短信通知
- 钉钉/企业微信
- Webhook回调
- 客户端通知

## 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 联系方式

- 作者: lzailai
- 邮箱: lzailai@163.com
- 项目地址: https://gitee.com/lzailai/easy


---

**注意**: 这是一个持续开发的项目，功能会不断更新和完善。请关注项目更新日志获取最新信息。