使用文档
快速开始
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. 登录并添加主机
- 使用默认账号登录
- 点击「+」添加远程主机(填写IP、端口、用户名、密码/密钥)
- 点击主机卡片即可打开SSH终端
功能说明
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_driver 为 mysql,并配置 db_source 连接字符串。终端连接失败怎么办? +
检查:① 主机地址和端口是否正确 ② 用户名密码是否正确 ③ 服务器防火墙是否允许SSH连接 ④ 使用「测试连接」功能排查
如何部署到生产环境? +
使用
docker-compose up -d 一键部署,或参考打包发版文档手动构建。建议修改 jwt_secret 并启用HTTPS。