🎯 项目简介
WindowsRemoteAdmin 是一款专为无法启用远程桌面服务的企业级Windows服务器环境设计的轻量级远程管理解决方案。无论是在严格的云安全策略下、受限的内网环境中，还是需要临时应急访问的场景，都能为您提供便捷、安全的远程管理能力。
🌟 核心优势
- 🛡️ 零信任架构 - 无需开启远程桌面，降低安全风险
- ⚡ 即时部署 - 无需数据库，下载即用，秒级启动
- 🔍 全程审计 - 完整的操作日志记录，满足合规要求
- 🎨 友好界面 - 独特的马里奥像素风格UI，提升操作体验
- 📱 跨平台访问 - 任何支持浏览器的设备均可管理
🎮 应用场景
| 场景 | 描述 | 解决方案 |
|---|---|---|
| ☁️ 云服务器管理 | Azure/AWS/GCP等云平台Windows实例 | 无需公网暴露RDP端口，通过Web安全访问 |
| 🔒 内网隔离环境 | 金融、政务等高安全要求网络 | 在不破坏网络隔离的前提下进行运维 |
| 🏢 企业私有云 | VMware/Hyper-V虚拟化环境 | 统一Web界面管理多台虚拟机 |
| 🚨 紧急故障处理 | 生产环境突发问题快速响应 | 移动端随时接入，快速定位解决问题 |
| 🔧 日常运维作业 | 系统监控、日志分析、文件传输 | 一站式运维工具平台 |
🚀 核心功能
📸 功能演示
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| #### 🔐 登录认证页面 
• 粉色马里奥像素风格设计 • 用户名+密码+用途三重验证 • 实时表单验证和错误提示 • 响应式布局适配各种设备 • 安全的AJAX异步登录 | #### 🎮 管理中心着陆页 
• 马里奥经典红蓝配色主题 • 实时系统时间动态显示 • 一键跳转PowerShell和文件管理 • 像素风格装饰元素动画 • 直观的功能导航入口 |
| #### 🔧 PowerShell控制台 
• 支持常用命令快速选择 • 多种编码格式切换 • 执行按钮智能防抖 • 命令历史记录回溯 • 实时输出结果显示 | #### 📁 文件资源管理器 
• 自定义路径导航 • 文件类型图标识别 • 详细属性信息展示 • 快速文件下载功能 • 直观的时间排序 |
| #### 📖 文本查看器 
• 支持<10MB文本文件 • 语法高亮显示 • 底部固定布局 • 快速滚动导航 • 字符编码自适应 | #### 📜 日志分析器 
• 关键词智能搜索 • 匹配内容高亮显示 • 时间范围精确筛选 • 大日志高效检索 • 多条件组合过滤 |
🛠️ 技术架构
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Web Browser │ │ Spring Boot 3 │ │ PowerShell │
│ (Any Platform) │◄──►│ Undertow │◄──►│ (Windows Only) │
└─────────────────┘ │ │ └─────────────────┘
│ Security Layer │
│ Audit Logging │
│ Session Mgmt │
└─────────────────┘🏗️ 核心组件
| 组件 | 技术栈 | 说明 |
|---|---|---|
| 后端框架 | Spring Boot 3.3.4 | 现代化Java生态，性能卓越 |
| Web容器 | Undertow | 轻量级高性能，内存占用低 |
| 安全认证 | Session + Cookie | 1天免登录，安全便捷 |
| 前端框架 | Bootstrap 5 + jQuery | 响应式设计，兼容性强 |
| 代码编辑 | CodeMirror 5 | 高性能文本渲染引擎 |
| PowerShell | jPowerShell 3.1.1 | Java-PowerShell桥接 |
| 构建工具 | Maven | 标准化项目构建 |
| 运行环境 | JDK 17 | LTS版本，稳定可靠 |
🔒 安全特性
- 🛡️ 认证授权 - 用户名+密码+用途三重验证
- 📋 操作审计 - 完整的操作日志记录
- 🔐 传输加密 - HTTPS安全通信保障
- ⏰ 会话管理 - 自动超时和安全退出
- 🌐 IP追踪 - 客户端来源地址记录
🚀 快速上手
📋 环境要求
# 必需环境
✅ Windows 7/Server 2008及以上版本
✅ JDK 17+ (推荐Microsoft Build of OpenJDK 17)
✅ 512MB可用内存
✅ 100MB磁盘空间
# 推荐配置
🌟 4GB内存以上
🌟 SSD存储
🌟 稳定网络连接🛠️ 部署步骤
1. 获取项目
# 方式一：Git克隆（推荐） git clone https://github.com/moshowgame/windows-remote-admin.git cd WindowsRemoteAdmin # 方式二：直接下载ZIP包 # 访问Release页面下载最新版本
2. 编译构建
# 清理并编译 mvn clean compile # 打包成可执行JAR mvn package -DskipTests
3. 启动服务
# 开发模式启动 mvn spring-boot:run # 生产模式启动 java -jar target/WindowsRemoteAdmin-2026.jar # 后台运行（Linux/macOS） nohup java -jar target/WindowsRemoteAdmin-2026.jar > app.log 2>&1 &
4. 访问验证
打开浏览器访问：http://localhost:12306/
看到粉色马里奥风格的登录界面即表示部署成功！🎉
🔧 配置说明
用户认证配置
在 src/main/resources/data/entitlement.csv 中添加用户：
username,password admin,admin123
端口修改
编辑 application-dev.yml：
server: port: 8080 # 修改为你想要的端口
🎮 首次使用指南
- 登录系统 - 使用配置的用户名密码登录
- 设置用途 - 填写本次操作的具体用途（必填）
- 开始管理 - 进入主控制台开始远程操作
- 安全退出 - 操作完成后记得点击退出按钮
📝 版本发布历史
🎉 v1.0.0 (2026-02-15) - 全新升级版
重大更新：全新品牌形象
- 🔄 品牌重塑 - 项目更名为WindowsRemoteAdmin，专注Windows远程管理
- 🎨 界面革新 - 全新的粉色马里奥像素风格UI设计
- 🏗️ 架构升级 - 包结构调整，代码组织更加清晰
- 🔧 路径优化 - 移除/sre路径前缀，访问更简洁
- 🛡️ 安全增强 - Cookie命名规范化，安全性提升