# OpsFlash

**Repository Path**: LeapSunrise/OpsFlash

## Basic Information

- **Project Name**: OpsFlash
- **Description**: OpsFlash: 轻量级运维极速引擎 (The Flash Engine for Micro-Ops)
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 1
- **Created**: 2026-08-11
- **Last Updated**: 2026-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpsFlash

轻量级运维极速引擎 (The Flash Engine for Micro-Ops)

![logo](./docs/images/logo64.png)

OpsFlash 是一款基于 **Wails v3 + Go + Vue 3** 的跨平台桌面运维工具。单二进制分发，本地 SQLite 存储，敏感凭据加密保护，让日常服务器运维轻快如一瞬闪电。

> 当前版本：v0.3.0 · License：MIT

## 仓库地址

- GitHub：<https://github.com/LeapSunrise26/OpsFlash>
- Gitee：<https://gitee.com/LeapSunrise/OpsFlash>

## 特性

- **用户与认证**：登录 / 登出，Token 会话（24h 过期），密码 bcrypt 哈希，用户管理（创建/修改/删除/角色）
- **连接管理**：SSH 连接统一管理，私钥 / 口令凭据本地加密存储，连接测试
- **SSH 隧道**：local / remote / dynamic 三种端口转发，一键启停、断线自动重连、应用启动自启、分组与批量创建
- **指令库**：命令统一管理（环境分组、本地 terminal / SSH 远程两种执行位置、cmd / PowerShell / Bash 脚本解释器）；非交互 / 交互终端 / 守护进程三种命令类型，ConPTY 实时输出、流式执行可停止
- **脚本库**：bat / ps1 / sh 脚本统一管理（环境分组、在线编辑、重命名、一键执行）；ConPTY 实时输出、多会话并行、可停止；Windows 走 WSL bash / Git Bash（自动探测路径挂载）
- **桌面体验**：系统托盘（关闭最小化）、每日日志文件

## 技术栈

| 层 | 技术 |
|----|------|
| 桌面框架 | [Wails v3](https://wails.io/)（v3.0.0-beta.4） |
| 后端语言 | Go 1.25 |
| 前端 | Vue 3 + TypeScript + Vite 8 |
| SSH | golang.org/x/crypto/ssh（纯 Go，无 CGO） |
| 存储 | SQLite（modernc.org/sqlite，纯 Go 驱动） |

## 快速开始

### 环境要求

- Go 1.25+
- Node.js 20+（前端构建）
- [Wails3 CLI](https://v3.wails.io/)

### 开发模式

```bash
wails3 dev
```

热重载前端与后端改动。

### 构建产物

```bash
wails3 build
```

生成生产可执行文件到 `bin/` 目录。构建后端为服务模式（无 GUI，纯 HTTP）：

```bash
task build:server   # 或 task run:server
```

### 默认账号

首次启动内置管理员账号：`admin` / `123456`（登录后请尽快修改）。

## 项目结构

```
├── main.go                 # 应用入口（窗口、托盘、菜单、事件）
├── server/                 # Go 后端
│   ├── authservice.go      # 登录/会话
│   ├── userservice.go      # 用户管理
│   ├── connections.go      # SSH 连接管理
│   ├── opsservice.go       # 指令库（命令 CRUD）
│   ├── opsruntime.go       # 指令库执行运行时（流式/交互/守护 + ConPTY 噪声清洗）
│   ├── executor.go         # 执行器工厂（terminal/ssh）
│   ├── tunnelservice.go    # SSH 隧道 CRUD
│   ├── tunnelcontrol.go    # 隧道启停/分组控制
│   ├── tunnelruntime.go    # 隧道运行时管理
│   ├── scriptservice.go    # 脚本库（CRUD + 执行 + 环境管理）
│   ├── scriptenv.go        # 环境 CRUD（指令库/脚本库归属）
│   ├── cmd/                # 命令构造（cmd/powershell/bash + WSL 路径转换）
│   ├── pty/                # PTY 传输层（Windows ConPTY / Unix creack/pty）
│   ├── daemon/             # 守护进程（Windows Job Object 进程树管理）
│   ├── exec/               # 执行器（terminal 本地 / ssh 远程）与连接测试
│   ├── secret/             # 凭据加密（DPAPI / AES-256-GCM）
│   └── tunnel/             # 隧道实现（local/remote/dynamic）
├── frontend/               # Vue 3 前端
│   └── src/components/pages/  # 页面：登录/首页/指令库/连接/隧道/用户/脚本库
├── docs/                   # 设计文档与数据库结构
└── build/                  # 平台打包配置
```

## 发布路线图

按阶段逐步开放能力：

| 阶段 | 版本 | 范围 |
|------|------|------|
| **第一阶段** | v0.1.0 | 用户管理、登录、首页、连接管理（SSH + 隧道管理） |
| **第二阶段** | v0.2.0 | 脚本库（bat/ps1/sh 本地脚本管理 + 一键执行） |
| **第三阶段** | v0.3.0 | 本地脚本：cmd、powershell、bash |
| **第四阶段** | v0.4.0 | 数据库执行：Redis、MySQL、TDengine |
| **第五阶段** | v0.5.0 | 指令编排（批量执行 + 依赖关系） |

## 文档

- [连接设计](./docs/connections-design.md)
- [隧道设计](./docs/tunnel-design.md)
- [数据库结构](./docs/database-schema.sql)

## 软件截图

连接管理
![opsflash01](./docs/images/opsflash01.png)
隧道管理
![opsflash02](./docs/images/opsflash02.png)

## 开源协议

本项目基于 [MIT](./LICENSE) 协议开源。使用、修改、商用、分发均需保留版权声明。

## 反馈与贡献

- 欢迎提 Issue / PR
- 安全漏洞请私信或邮件至维护者，勿直接公开