# DevEnv-Open
**Repository Path**: FSW_ei/DevEnv-Open
## Basic Information
- **Project Name**: DevEnv-Open
- **Description**: DevEnv open source version
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-20
- **Last Updated**: 2025-12-21
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 生产（完全）版项目地址：
[GitHub - DevEnv 生产版](https://www.devenv.com.cn)
# DevEnv 开源版 🚀
[](https://opensource.org/licenses/MIT)
[](https://github.com/devenv-project/devenv-opensource)
[](https://www.docker.com/)
**DevEnv 开源版** 是一个轻量级的开发环境自动化配置工具，帮助开发者快速搭建和配置开发环境。通过简洁的 Web 界面，您可以轻松选择所需的开发工具，生成自动化安装脚本，一键完成开发环境的部署。
## ✨ 核心特性
### 🎯 软件选择与管理
- **精选软件库**：包含常用的开发工具和软件包
- **分类浏览**：按开发语言、工具类型等分类查看
- **智能搜索**：支持按名称快速搜索软件
- **批量选择**：支持多软件批量添加和管理
### 🛠️ 脚本生成
- **跨平台支持**：Windows、Linux、macOS 三大平台
- **自定义配置**：可配置安装路径、镜像源等参数
- **模拟脚本生成**：开源版提供脚本生成演示功能
- **简洁易用**：一键生成可执行的安装脚本
### 👥 基础用户系统
- **用户注册登录**：基于JWT的安全认证
- **个人资料管理**：管理基本个人信息
- **轻量化设计**：专注核心功能，简化用户体验
## 🏗️ 技术架构
### 后端技术栈
- **Java 17** + **Spring Boot 3.x**
- **Spring Security** - 安全认证框架
- **Spring Data JPA** - 数据持久化
- **MySQL 8.0** - 主数据库
- **Redis** - 缓存和会话存储
- **Maven** - 项目构建管理
### 前端技术栈
- **Vue.js 3** + **Composition API**
- **Element Plus** - UI 组件库
- **Pinia** - 状态管理
- **Vue Router** - 路由管理
- **Axios** - HTTP 请求库
- **Vite** - 构建工具
### 部署技术
- **Docker** + **Docker Compose**
- **Nginx** - 反向代理和静态文件服务
## 🚀 快速开始
### 环境要求
- **Docker** >= 20.10 和 **Docker Compose** >= 2.0（推荐）
- 或者：**Node.js** >= 18.0.0, **Java** >= 17, **MySQL** >= 8.0, **Redis** >= 6.0
### 🐳 Docker 一键部署（推荐）
1. **克隆项目**
```bash
git clone https://github.com/devenv-project/devenv-opensource.git
cd devenv-opensource
```
2. **启动所有服务**
```bash
# 启动所有服务（首次运行会自动构建镜像）
docker-compose up -d
# 查看运行状态
docker-compose ps
```
3. **访问应用**
- 🌐 前端地址：http://localhost:3000
- 🔧 后端API：http://localhost:8081/api
- 🗄️ 数据库端口：localhost:3307
### 🛑 停止服务
```bash
# 停止所有服务
docker-compose down
# 清理数据（可选，会删除所有数据）
docker-compose down -v
```
### 💻 本地开发部署
点击展开本地开发部署说明
#### 后端启动
1. **准备数据库**
```sql
CREATE DATABASE devenv_opensource CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'devenv'@'localhost' IDENTIFIED BY 'devenv123';
GRANT ALL PRIVILEGES ON devenv_opensource.* TO 'devenv'@'localhost';
FLUSH PRIVILEGES;
```
2. **启动 Redis**
```bash
# 使用 Docker 启动 Redis
docker run -d --name redis -p 6379:6379 redis:7-alpine
```
3. **配置后端**
```bash
cd backend
# 修改 application.yml 中的数据库连接信息（如需要）
```
4. **启动后端服务**
```bash
# 使用 Maven 启动
./mvnw spring-boot:run
```
#### 前端启动
1. **安装依赖**
```bash
cd frontend
npm install
```
2. **启动开发服务器**
```bash
npm run dev
```
## 📖 使用指南
### 1. 首次使用
1. 🌐 访问 http://localhost:3000
2. 📝 点击"注册"创建新账户
3. 🔐 使用用户名和密码登录系统
### 2. 选择软件
1. 📋 在软件选择页面浏览可用软件
2. 🔍 使用搜索功能快速找到所需软件
3. ➕ 点击软件卡片添加到选择列表
4. 🏷️ 支持按分类筛选和批量操作
### 3. 生成脚本
1. ⚙️ 在脚本生成页面配置安装参数
2. 🖥️ 选择目标操作系统
3. 📁 设置安装路径
4. 🚀 点击"生成脚本"查看结果
### 4. 个人中心
1. 👤 在个人中心管理基本信息
2. 🔧 查看和编辑个人资料
3. 📊 查看账户统计信息
## 🔧 配置说明
### Docker 部署配置
所有服务配置都在 `docker-compose.yml` 中：
```yaml
services:
mysql:
ports:
- "3307:3306" # 外部端口:内部端口
redis:
ports:
- "6379:6379"
backend:
ports:
- "8081:8080" # 后端服务端口
frontend:
ports:
- "3000:3000" # 前端服务端口
```
### 数据持久化
- **MySQL数据**：存储在 Docker volume `mysql-data` 中
- **Redis数据**：存储在 Docker volume `redis-data` 中
- **应用日志**：存储在 `./logs/` 目录中
## 📦 项目结构
```
devenv-opensource/
├── 📁 backend/ # 后端 Spring Boot 应用
│ ├── 📁 src/main/java/ # Java 源码
│ ├── 📁 src/main/resources/ # 配置文件和静态资源
│ └── 📄 pom.xml # Maven 配置
├── 📁 frontend/ # 前端 Vue.js 应用
│ ├── 📁 src/ # Vue.js 源码
│ ├── 📁 public/ # 静态资源
│ └── 📄 package.json # npm 配置
├── 📁 database/ # 数据库初始化脚本
├── 📁 config/ # 配置文件
├── 📁 data/ # 应用数据文件
└── 📄 docker-compose.yml # Docker 编排文件
```
## 🔒 安全说明
### 默认配置
- **数据库密码**：`devenv123`（生产环境请修改）
- **JWT 密钥**：自动生成（存储在配置文件中）
- **端口暴露**：仅暴露必要的服务端口
### 生产环境建议
1. 🔐 修改所有默认密码
2. 🌐 使用 HTTPS 和域名访问
3. 🛡️ 配置防火墙规则
4. 🔄 定期备份数据
## 🤝 参与贡献
我们欢迎各种形式的贡献！
### 贡献方式
- 🐛 **报告问题**：[提交 Issue](https://github.com/devenv-project/devenv-opensource/issues)
- ✨ **功能建议**：[发起讨论](https://github.com/devenv-project/devenv-opensource/discussions)
- 🔧 **代码贡献**：Fork 项目并提交 Pull Request
- 📖 **文档改进**：改进文档和使用说明
### 开发流程
1. Fork 项目到您的 GitHub
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request
## ❓ 常见问题
Q: 容器启动失败怎么办？
A: 请检查：
1. Docker 和 Docker Compose 是否正确安装
2. 端口 3000、3307、6379、8081 是否被占用
3. 查看容器日志：`docker-compose logs [service-name]`
Q: 如何添加新的软件包？
A: 编辑 `backend/src/main/resources/data/software-samples.json` 文件，添加新的软件信息，然后重启后端服务。
Q: 如何备份数据？
A:
```bash
# 备份数据库
docker exec devenv-opensource-mysql mysqldump -u devenv -pdevenv123 devenv_opensource > backup.sql
# 备份 Docker volumes
docker run --rm -v mysql-data:/data -v $(pwd):/backup ubuntu tar czf /backup/mysql-backup.tar.gz /data
```
Q: 开源版和完整版有什么区别？
A: 开源版专注于核心功能：
- ✅ 软件选择和浏览
- ✅ 基本用户系统
- ✅ 脚本生成演示
- ❌ 高级统计分析
- ❌ 企业级功能
- ❌ 商业支持
## 📝 更新日志
### v1.0.0 (2025-08-07)
- 🎉 首次发布开源版本
- ✨ 基础软件选择功能
- 👤 用户注册登录系统
- 🐳 Docker 一键部署支持
- 📱 响应式界面设计
## 📄 许可证
本项目基于 [MIT 许可证](LICENSE) 开源。
MIT 许可证是一个宽松的开源许可证，允许您：
- ✅ 商业使用
- ✅ 修改代码
- ✅ 分发
- ✅ 私人使用
## 🌟 支持项目
如果这个项目对您有帮助，请：
1. ⭐ 给项目点个 Star
2. 🐛 报告问题和建议
3. 🔧 贡献代码和文档
4. 📢 分享给其他开发者
## 📞 联系方式
- 📧 **Issues**: [GitHub Issues](https://github.com/devenv-project/devenv-opensource/issues)
- 💬 **讨论**: [GitHub Discussions](https://github.com/devenv-project/devenv-opensource/discussions)
---
**DevEnv 开源版 - 让开发环境配置变得简单** 🚀
Made with ❤️ by DevEnv Team