SpringBootRemotePowershellAdmin:开箱即用的 Windows远程运维开源工具
🌟SpringBootRemotePowershellAdmin:无 DB 依赖的 Windows 远程运维工具,开箱即用!
还在为远程维护 Windows 服务器头疼?装复杂客户端、担心命令执行安全、日志查看要传文件… 这些麻烦事,用「SpringBootRemotePowershellAdmin」就能解决!
它是基于SpringBoot3+jPowershell的轻量级工具,不用装数据库,解压启动就能用 —— 支持 PowerShell 白名单命令、10M 内日志高亮搜索、文件浏览下载,帮 Java 开发者 / 运维快速搞定 Windows 服务器远程管理。
✅ 3 大核心价值,解决远程运维痛点
- 轻量无依赖:不用部署 MySQL/Redis,JDK17+Maven 就能跑,单机启动仅需 30 秒
- 安全可控:PowerShell 命令限「白名单」,操作全程记审计日志,避免误执行风险
- 功能全场景:不止能远程执行命令,日志查看、文件下载一次搞定,不用切换多工具
🌟 4 个实用功能,覆盖日常运维需求
每个功能都精准匹配「Windows 远程维护」场景,上手零学习成本:
1. 📂 文件夹探索:可视化浏览服务器目录
- 支持自定义输入路径(比如
D:\logs\
),自动显示文件 / 文件夹的名称、大小、修改时间 - 区分文件 / 文件夹类型,避免误操作;长路径自动适配显示,不用手动拼接路径
2. 📄 日志查看:10M 内日志秒加载 + 关键词高亮
- 直接输入日志路径(如
D:\app\error.log
),支持按关键词搜索,结果实时高亮 - 可限制「查询天数」,避免加载大日志卡顿;界面适配长文本,阅读不滚屏
3. 📥 文件操作:预览 + 下载一步到位
- 文本文件(如配置文件)支持「只读预览」,避免远程修改误删
- 任意文件(压缩包、安装包)可直接下载到本地,不用开 FTP
4. ⚡ PowerShell 命令:白名单 + 防抖 + 审计
- 仅允许执行「白名单命令」(如
Get-Process
查看进程、Get-ChildItem
列目录) - 常用命令可快速选择,执行按钮带防抖,避免重复提交;每步操作都记审计日志,追溯方便
👉 功能预览:项目根目录含「文件夹浏览、日志查看、命令执行」截图,启动后直观可见~
🚀 3 步快速上手,5 分钟跑通
1. 环境准备(必看!)
- 安装 JDK17(推荐微软 MSJDK17,兼容性更好),配置
JAVA_HOME
环境变量 - Maven 国内用户:建议配阿里云镜像(加速依赖下载),在
settings.xml
加:
<mirror><id>aliyunmaven</id><mirrorOf>central</mirrorOf><url>https://maven.aliyun.com/repository/public</url>
</mirror>
2. 构建 + 启动
- 克隆项目到本地:
git clone https://github.com/moshowgame/ServerRemoteExecution.git
cd ServerRemoteExecution
- 编译项目:
mvn clean compile
- 启动项目:找到
src/main/java/[你的包路径]/Application.java
(比如com/moshow/server/Application.java
),直接运行main
方法(IDEA/Eclipse 都支持)
3. 验证启动
打开浏览器访问:http://localhost:12306/sre/
看到 hello world - https://zhengkai.blog.csdn.net/
,说明启动成功!
🛠️ 技术栈揭秘:为什么选这些组件?
- 核心框架:SpringBoot3 → 简化配置,自带 Web 能力,开发者熟悉度高
- Web 容器:Undertow → 替代 Tomcat,更轻量、启动快,适合工具类项目
- 前端组件:CodeMirror5 → 解决日志 / 文本渲染卡顿,支持关键词高亮
- 运行环境:JDK17 → 兼容 SpringBoot3,性能比 JDK8 更优
- 支持系统:Windows Only(当前版本,后续计划加 Linux Bash 支持)
❓ 新手必看:4 个常见问题解答
Q1:为什么日志查看限制「<10M」?
A:避免大文件加载导致内存溢出~若需支持更大日志,找到 LogViewer
模块,搜索 fileSize < 10 * 1024 * 1024
,修改数值即可(比如改成 20M 就是 20 * 1024 * 1024
)
Q2:怎么配置 PowerShell 命令白名单?
A:打开 src/main/resources/application.yml
,加以下配置(逗号分隔允许的命令):
sre:powershell:whitelist: Get-Process,Get-Item,Get-ChildItem
Q3:审计日志存在哪里?怎么看?
A:不用数据库!审计日志默认存在 logs/sre-audit.log
,打开就能看操作记录;想改路径,修改 logback.xml
里的 sre-audit
日志节点即可。
Q4:支持 Linux 服务器吗?
A:当前版本仅支持 Windows(依赖 PowerShell 环境),后续会在 develop
分支加 Linux Bash 支持,关注项目更新就能第一时间用~
📌 最后:邀请你一起完善项目
项目已开源在 GitHub:https://github.com/moshowgame/SpringBootRemotePowershellAdmin如果你有需求,或发现 Bug,欢迎提 Issue/PR~觉得好用的话,别忘了给个 Star,让更多人看到这个轻量运维工具!