# 统一脚本管理平台

**Repository Path**: yang-chen520xl/script-manager

## Basic Information

- **Project Name**: 统一脚本管理平台
- **Description**: 统一脚本管理平台
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-06
- **Last Updated**: 2026-03-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 统一脚本管理平台 (OpsMaster)

一个基于 FastAPI + React 的统一脚本管理平台，支持远程主机管理、脚本执行、定时任务调度等功能。

## 功能特性

- **用户管理**：支持多用户登录、角色权限管理
- **主机管理**：管理远程主机，支持 SSH 连接
- **脚本管理**：脚本版本控制、分类管理、语法高亮编辑
- **任务执行**：支持即时执行和定时调度
- **执行记录**：详细的执行日志和审计追踪
- **仪表盘**：可视化统计数据展示

## 技术栈

### 后端
- **FastAPI** - 高性能 Python Web 框架
- **SQLAlchemy** - ORM 数据库操作
- **PostgreSQL** - 关系型数据库
- **Paramiko** - SSH 连接库
- **APScheduler** - 定时任务调度
- **JWT** - 身份认证

### 前端
- **React 19** - 用户界面框架
- **TypeScript** - 类型安全的 JavaScript
- **Vite** - 构建工具
- **Tailwind CSS** - 原子化 CSS 框架
- **Radix UI** - 无障碍 UI 组件
- **Monaco Editor** - 代码编辑器

## 快速开始

### 环境要求
- Python 3.9+
- Node.js 18+
- PostgreSQL 13+

### 使用 Docker Compose 部署（推荐）

```bash
# 克隆项目
git clone <your-repo-url>
cd 统一脚本管理平台

# 启动服务
docker-compose up -d

# 访问应用
# 前端: http://localhost
# 后端 API: http://localhost:8000
# API 文档: http://localhost:8000/docs
```

### 手动部署

#### 后端部署

```bash
cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件配置数据库连接等信息

# 启动服务
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

#### 前端部署

```bash
cd app

# 安装依赖
npm install

# 开发模式
npm run dev

# 生产构建
npm run build
```

## 项目结构

```
.
├── app/                    # 前端项目
│   ├── src/
│   │   ├── components/     # UI 组件
│   │   ├── pages/          # 页面组件
│   │   ├── services/       # API 服务
│   │   ├── hooks/          # 自定义 Hooks
│   │   └── types/          # TypeScript 类型定义
│   ├── package.json
│   └── Dockerfile
├── backend/                # 后端项目
│   ├── app/
│   │   ├── core/           # 核心配置
│   │   ├── models/         # 数据模型
│   │   ├── routers/        # API 路由
│   │   ├── schemas/        # Pydantic 模型
│   │   └── services/       # 业务逻辑
│   ├── requirements.txt
│   └── Dockerfile
├── docker-compose.yml      # Docker 编排配置
└── README.md
```

## 默认账号

- **用户名**: `admin`
- **密码**: `admin123`

> ⚠️ 生产环境请务必修改默认密码！

## API 文档

启动后端服务后，访问以下地址查看 API 文档：

- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc

## 贡献指南

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) 协议开源。

## 联系方式

如有问题或建议，欢迎提交 Issue 或 Pull Request。