chore: trim repo for customer delivery
This commit is contained in:
123
README.md
123
README.md
@@ -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. 能导出一次备份
|
||||
|
||||
Reference in New Issue
Block a user