项目概述
Termix 是一款基于 Web 的服务器管理平台,把 SSH 终端、端口隧道与文件编辑融为一体,旨在用浏览器即可完成日常运维。它面向需要跨平台与快速协作的个人和小团队,解决传统本地客户端分散、配置繁琐、环境不一致的问题。通过集中化接入与无客户端使用,Termix 让多主机连接、临时转发与在线编辑变得简单流畅;借助 TypeScript/React 等现代技术栈与 Docker、SQLite 的轻量部署,它兼具易用、可扩展与私有化落地的优势,显著降低上手与维护成本。
项目统计
项目概况
1878 Stars |
68 Forks |
1878 Watchers |
39 Issues
开源协议: Other |
创建于: 2024-11-25 |
更新于: 2025-09-02
技术栈
该项目主要使用 TypeScript 开发,占代码库的 98.9%。此外还包含 CSS (0.7%)、Dockerfile (0.2%)、JavaScript (0.1%)
核心功能
Termix 让你在浏览器里优雅地管服务器:无需本地客户端,一键连上远端主机,日常维护更轻松。
- Web SSH 终端:低延迟交互,完整支持常见终端控制序列,在任何设备上即开即用。
- 隧道与端口转发:将远端 TCP/HTTP 服务安全映射到本地或公网,适用于调试、内网穿透与服务共享。
- 文件管理与在线编辑:浏览目录、上传下载,直接在页面上修改配置与脚本,改完即生效。
- 连接管理:集中维护主机与凭据,切换与组织多台服务器更顺手。
- 即刻部署:提供 Docker 镜像,安装与升级一条龙,迁移也更省心。
- 轻量后端:TypeScript/Node.js 配合 SQLite,配置简单、资源占用低、备份方便。
- 现代界面:React + Vite + Tailwind + Radix UI,操作顺滑、观感清爽。
- 安全默认:遵循 SSH 的密钥/密码认证与加密通道,尽量减少暴露面。
更多功能特性正在不断完善中。
技术架构
Termix 采用前后端分离的 TypeScript 全栈架构。前端以 React + Vite 构建 SPA,配合 Tailwind CSS 与 Radix UI 提供一致、可访问的交互体验。后端基于 Node.js 实现 API 与实时通道的编排,承载 SSH 终端、隧道与文件编辑等能力;SQLite 作为内嵌数据库,持久化连接配置与会话信息,部署上通过 Docker 提供可复制、可移植的运行环境。
核心设计理念与选型优势:
- 端到端类型安全:前后端共享类型,降低接口错配与运行时错误。
- 轻量与易运维:SQLite 零运维成本,适合单机与边缘场景。
- 实时与可扩展:利用 WebSocket 等双工通道进行终端流式传输与文件变更推送,便于横向扩展与资源隔离。
典型技术流程(逻辑图描述):浏览器 UI 发起请求 → 后端鉴权与会话管理 → 建立到目标主机的 SSH 通道/隧道 → 标准输入输出按块转发至前端终端视图,文件读写通过同一会话安全执行并同步反馈。
使用指南
Termix 通过浏览器管理服务器,内置 SSH 终端、隧道与文件编辑。推荐用 Docker 快速启动,数据落盘到本地目录,方便备份与升级。
- 下载与配置
git clone https://github.com/LukeGus/Termix.git && cd Termix
printf "PORT=8080\nDATABASE_URL=file:./data/termix.db\n" > .env
- 构建并运行
docker build -t termix .
docker run -d --name termix -p 8080:8080 --env-file .env -v "$PWD/data:/app/data" termix
- 首次使用
- 访问 http://localhost:8080 并注册账户。
- 在“主机”中新建连接:填写 Host/Port/Username,认证选择 Password 或 Private Key(可粘贴私钥,必要时输入 Passphrase)。
- 保存后即可在浏览器中开启终端、浏览/编辑文件;在“隧道”中可创建本地/远程端口转发。
- 常用运维
docker logs -f termix
docker restart termix
docker stop termix && docker rm termix
提示
- 生产环境请将 8080 改为反向代理端口并启用 HTTPS。
- 更多环境变量与高级配置请参考仓库文档与示例文件。
总结评价
Termix 是一款基于 Web 的服务器管理平台,集成 SSH 终端、隧道与文件编辑,采用 React/TypeScript/Vite 等现代栈,支持 Docker 快速部署。约 1.9k Stars 显示一定热度,配套 Discord 便于反馈与迭代。亮点在于将常用远程运维能力集中到浏览器,降低多端切换成本。建议在生产前重点评估安全性(密钥/会话隔离、审计与 RBAC)、可扩展性(外部数据库、高并发)与备份策略。后续可关注 SSO、插件化与多用户治理等方向。适合个人与中小团队自托管场景。




