项目地址:https://github.com/gswenxue/QxueSSH
📋 项目概况
- 定位:基于浏览器的服务器管理面板。
- 许可:MIT 协议,可自由使用和修改。
🛠 技术架构
- 后端:Node.js + Express + Socket.IO + ssh2 + node-pty(本机终端)
- 前端:原生 JavaScript + xterm.js,全部资源自托管,无外部 CDN 请求
- 存储:JSON 文件存储(
data/db.json),无外部数据库依赖- 认证:bcryptjs 哈希 + Token(3 天有效期,滑动续期)
✨ 主要功能
- SSH 终端:多标签、主机收藏、手动排序、密码/私钥认证、移动端快捷键条、多主题
- SFTP 文件管理:目录浏览、上传下载、批量操作、拖拽上传、在线文本编辑器
- 实时监控:CPU、内存、Swap、磁盘、网络速率,兼容 Alpine/BusyBox
- Docker 管理:容器列表、日志查看、启停重启、镜像管理
- 账户安全:图形验证码、登录失败锁定、注册默认关闭、管理员可开关注册
- 数据安全:数据库整文件 AES-256-GCM 加密、前端资源完全自托管、WebDAV 自动备份
🎯 适用场景建议
- 适合:个人开发者、小型团队管理少量 VPS/服务器,追求开箱即用的集成面板。
- 不适合:对安全性要求极高的生产环境、需要多用户精细权限管控的企业场景。
- 建议:如果对安全性有更高要求,可关注 Nexus Terminal(支持 2FA 和操作审计)或 Termix(支持多协议和 OIDC/LDAP 登录)。
🚀 快速上手
bash
# 一键部署(Debian/Ubuntu/CentOS/Alpine)
curl -O https://raw.githubusercontent.com/gswenxue/QxueSSH/main/install.sh && bash install.sh部署过程中会交互式设置管理员账号、密码和端口。部署完成后使用
qxuessh 命令管理服务(重启/停止/修改端口/重置密码等)。⚠️ 风险提示
使用前务必注意:强密码是底线,如使用默认管理员密码请第一时间修改,不要将
data/ 目录提交到公开仓库。