chore: trim repo for customer delivery

This commit is contained in:
liumangmang
2026-04-17 17:53:06 +08:00
parent fa1b6707f7
commit 00ccd33961
36 changed files with 565 additions and 3519 deletions

123
README.md
View File

@@ -1,47 +1,16 @@
# SSH 管理器
# SSH 管理器部署说明
这是一个适合按“源码 + Docker 部署”方式售卖的 SSH / SFTP 管理项目
这是一份直接给客户使用的部署文档
买家拿到后,不需要装 Windows 客户端,只要会用 Docker就能按说明启动。后面如果要二开也可以直接在源码上改
你只需要按下面步骤启动,不需要看开发文档
## 这项目适合谁
- 经常连服务器的开发者
- 小团队运维
- NAS / 云主机用户
- 想找 FinalShell / MobaXterm 替代方案的人
## 这项目能做什么
- SSH 终端
- SFTP 文件管理
- 批量命令执行
- 连接和会话树备份恢复
- 历史日志与传输记录
- 默认管理员首次登录强制改密
## 建议怎么卖
建议你对外只卖这一种:
`源码交付 + Docker 部署版`
建议交付给买家的内容只有这几样:
1. 当前仓库源码
2. 这份 `README.md`
3. 默认账号说明
4. Docker 部署说明
不再提供 Windows 安装包,也不再提供双击启动脚本。
## 最简单的启动方式
先准备:
## 先准备
- Docker
- Docker Compose
## 启动
在项目根目录执行:
```bash
@@ -52,13 +21,21 @@ docker compose -f docker/docker-compose.yml up -d --build
`http://localhost:48080`
默认登录账号
## 默认登录账号
- 用户名:`admin`
- 密码:`admin123`
首次登录后请先修改密码。
## 这个版本能做什么
- SSH 终端
- SFTP 文件管理
- 批量命令执行
- 连接和会话树备份恢复
- 历史日志与传输记录
## 常用命令
启动:
@@ -85,7 +62,7 @@ docker compose -f docker/docker-compose.yml down
docker compose -f docker/docker-compose.yml ps
```
如果你习惯 `make`,也可以直接用:
如果你的环境已经安装了 `make`,也可以用:
```bash
make up
@@ -93,11 +70,11 @@ make logs
make down
```
## 数据会放在哪里
## 数据说明
Docker 默认把数据放在命名卷 `app-data` 里。
数据默认保存在 Docker 命名卷 `app-data` 里。
日常停止服务用:
平时停止服务请使用:
```bash
docker compose -f docker/docker-compose.yml down
@@ -109,58 +86,20 @@ docker compose -f docker/docker-compose.yml down
docker compose -f docker/docker-compose.yml down -v
```
因为这会把数据一起删
因为这会把数据一起删
## 给买家时可以直接这样说
## 遇到问题先检查
```text
这是源码交付 + Docker 部署版,不是练手 demo。
买回去后按说明执行一条 docker compose 命令就能跑起来。
支持 SSH、SFTP、批量命令、备份恢复适合开发者、运维和 NAS 用户。
```
1. Docker 是否正常启动
2. 端口 `48080` 是否被占用
3. 执行 `docker compose -f docker/docker-compose.yml logs -f` 查看报错
4. 确认浏览器访问的是 `http://localhost:48080`
闲鱼商品文案见:
## 建议启动后检查一遍
- `docs/xianyu-sales-copy.md`
## 如果你自己要开发
后端:
```bash
cd backend
mvn spring-boot:run
```
前端:
```bash
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
1. 能正常登录并修改密码
2. 能创建一条连接
3. 能打开终端
4. 能打开 SFTP
5. 能执行一次批量命令
6. 能导出一次备份