使用文档

快速开始

1. 启动后端服务

cd nexterm_api
go mod tidy
go run main.go

服务默认监听 http://localhost:8080,默认管理员账号:admin / admin123

2. 启动客户端

cd nexterm_app
flutter pub get
flutter run

选择目标平台运行:Chrome(Web)、Windows、macOS、Android 或 iOS。

3. 登录并添加主机

功能说明

SSH 终端

支持完整的终端模拟,包括256色输出、窗口大小自适应、多标签页。桌面端支持左右分栏布局,移动端提供全屏终端。

SFTP 文件管理

在主机菜单中选择「文件管理」,可以浏览远程目录、上传下载文件、创建目录、修改权限。

密钥管理

支持 Ed25519 和 RSA 密钥,可在线生成密钥对或导入已有密钥。私钥使用AES-GCM加密存储。

分组管理

支持创建多层级分组,将主机按项目、环境等维度分类管理。

API 文档

后端提供完整的 RESTful API,所有接口使用 JWT 认证:

POST   /api/v1/auth/login          登录
POST   /api/v1/auth/register       注册
GET    /api/v1/hosts               主机列表
POST   /api/v1/hosts               创建主机
POST   /api/v1/hosts/:id/test      测试连接
WS     /api/v1/terminal/ws/:hostId 终端WebSocket
GET    /api/v1/sftp/list            文件列表
POST   /api/v1/sftp/upload          上传文件
GET    /api/v1/sftp/download        下载文件

常见问题

如何修改API服务端口? +
编辑 conf/app.conf 中的 httpport 配置项。
如何切换MySQL数据库? +
修改 conf/app.conf 中的 db_drivermysql,并配置 db_source 连接字符串。
终端连接失败怎么办? +
检查:① 主机地址和端口是否正确 ② 用户名密码是否正确 ③ 服务器防火墙是否允许SSH连接 ④ 使用「测试连接」功能排查
如何部署到生产环境? +
使用 docker-compose up -d 一键部署,或参考打包发版文档手动构建。建议修改 jwt_secret 并启用HTTPS。