e2f600c2647e4dfb493090a242a1c41d18b3cb29
问题: - Docker 环境下上传文件时出现 FileNotFoundException - Tomcat 在异步任务执行前清理了临时文件 /tmp/tomcat.xxx/work/... 解决方案: 1. 配置 multipart.location 为持久化目录 ./data/upload-temp 2. 设置 file-size-threshold: 0 强制立即写入磁盘 3. 修改 SftpController.upload() 方法: - 在异步任务执行前将 MultipartFile 保存到持久化位置 - 异步任务从保存的文件读取而非 MultipartFile.getInputStream() - 上传完成或失败后自动清理临时文件 影响范围: - backend/src/main/resources/application.yml - backend/src/main/java/com/sshmanager/controller/SftpController.java
SSH 管理器
基于 Web 的 SSH 连接管理工具,支持终端与 SFTP 文件传输。技术栈:Vue 3、Spring Boot(JDK 8)、JSch、xterm.js。
功能
- 认证:本地用户登录(JWT)
- 连接管理:SSH 连接的增删改查(密码或私钥)
- Web 终端:通过 WebSocket + xterm.js 实现实时 SSH 终端
- SFTP:文件浏览,支持上传、下载、删除、创建目录
环境要求
- JDK 8+
- Node.js 18+
- Maven 3.6+
快速开始
后端
cd backend
mvn spring-boot:run
后端运行在 http://localhost:48080
默认登录:admin / admin123
前端
cd frontend
npm install
npm run dev
前端运行在 http://localhost:5173(API 与 WebSocket 会代理到后端)
生产构建
# 后端
cd backend && mvn package
# 前端
cd frontend && npm run build
将 frontend/dist 目录内容复制到后端的静态资源目录,或单独部署前端。
项目结构
ssh-manager/
├── backend/ # Spring Boot(JDK 8)
│ └── src/main/java/com/sshmanager/
│ ├── config/ # 安全、WebSocket、CORS
│ ├── controller/
│ ├── service/
│ ├── entity/
│ └── repository/
├── frontend/ # Vue 3 + Vite + Tailwind
│ └── src/
│ ├── views/
│ ├── components/
│ ├── stores/
│ └── api/
└── docs/design-system/ # UI/UX 规范
配置
后端(application.yml)
sshmanager.encryption-key:用于加密连接密码的 Base64 32 字节密钥sshmanager.jwt-secret:JWT 签名密钥spring.datasource.url:H2 数据库路径(默认:./data/sshmanager)
环境变量
SSHMANAGER_ENCRYPTION_KEY:覆盖加密密钥SSHMANAGER_JWT_SECRET:覆盖 JWT 密钥
安全说明
- 连接密码与私钥均以 AES-256-GCM 加密存储
- 所有 API 接口需 JWT 认证
- WebSocket 连接在握手时校验 JWT
- CORS 仅允许前端来源
Description