ssh-manager/README.md

SSH 管理器

这是一个适合按“源码 + Docker 部署”方式售卖的 SSH / SFTP 管理项目。

买家拿到后，不需要装 Windows 客户端，只要会用 Docker，就能按说明启动。后面如果要二开，也可以直接在源码上改。

这项目适合谁

• 经常连服务器的开发者
• 小团队运维
• NAS / 云主机用户
• 想找 FinalShell / MobaXterm 替代方案的人

这项目能做什么

• SSH 终端
• SFTP 文件管理
• 批量命令执行
• 连接和会话树备份恢复
• 历史日志与传输记录
• 默认管理员首次登录强制改密

建议怎么卖

建议你对外只卖这一种：

源码交付 + Docker 部署版

建议交付给买家的内容只有这几样：

1. 当前仓库源码
2. 这份 README.md
3. 默认账号说明
4. Docker 部署说明

不再提供 Windows 安装包，也不再提供双击启动脚本。

最简单的启动方式

先准备：

• Docker
• Docker Compose

在项目根目录执行：

docker compose -f docker/docker-compose.yml up -d --build

启动后访问：

http://localhost:48080

默认登录账号：

• 用户名：admin
• 密码：admin123

首次登录后请先修改密码。

常用命令

启动：

docker compose -f docker/docker-compose.yml up -d --build

查看日志：

docker compose -f docker/docker-compose.yml logs -f

停止：

docker compose -f docker/docker-compose.yml down

查看状态：

docker compose -f docker/docker-compose.yml ps

如果你习惯 make，也可以直接用：

make up
make logs
make down

数据会放在哪里

Docker 默认把数据放在命名卷 app-data 里。

日常停止服务用：

docker compose -f docker/docker-compose.yml down

不要执行：

docker compose -f docker/docker-compose.yml down -v

因为这会把数据一起删掉。

给买家时可以直接这样说

这是源码交付 + Docker 部署版，不是练手 demo。
买回去后按说明执行一条 docker compose 命令就能跑起来。
支持 SSH、SFTP、批量命令、备份恢复，适合开发者、运维和 NAS 用户。

闲鱼商品文案见：

• docs/xianyu-sales-copy.md

如果你自己要开发

后端：

cd backend
mvn spring-boot:run

前端：

cd frontend
npm install
npm run dev

前端开发地址：

http://localhost:5173

后端开发地址：

http://localhost:48080

环境变量

• SSHMANAGER_ENCRYPTION_KEY：连接密码加密密钥
• SSHMANAGER_JWT_SECRET：JWT 密钥
• DATA_DIR：数据目录

Docker 默认已经在 docker/docker-compose.yml 里给了可运行示例。正式卖给客户时，建议你改成自己的密钥再交付。

发货前自己至少检查一遍

1. Docker 版能正常启动
2. 能正常登录并修改密码
3. 能创建一条连接
4. 能打开终端
5. 能打开 SFTP
6. 能导出一次备份