Evildoerblockhouse900/websh
GitHub: Evildoerblockhouse900/websh
在浏览器中提供轻量级 SSH 终端,无需构建步骤和服务端依赖,通过 HTTP 长轮询适配共享主机等受限环境。
Stars: 0 | Forks: 0
# 🖥️ websh - 在浏览器中运行 SSH
[](https://github.com/Evildoerblockhouse900/websh)
## 🚀 功能介绍
websh 为您提供了一个运行在浏览器中的基于 Web 的 SSH 终端。它允许您连接到远程机器,并通过一个简单的页面使用功能完整的终端。
它的设计旨在保持轻量级。没有额外的依赖项,也没有构建步骤。这使得设置变得简单,并且更容易在共享主机、小型服务器或基本的 PHP 或 Python 环境中运行。
## 📥 下载和安装
1. 在此处打开下载页面:[GitHub 上的 websh](https://github.com/Evildoerblockhouse900/websh)
2. 将项目文件下载到您的 Windows PC
3. 如果文件是 ZIP 压缩包,请右键单击它并选择**全部提取**
4. 将提取的文件夹移动到您容易找到的位置,例如**下载**或**文档**
5. 打开文件夹并找到主应用程序文件
6. 如果您使用本地服务器工具,请将该文件夹放在服务器的 Web 根目录中
7. 使用服务器工具显示的本地地址在浏览器中打开该应用程序
如果您从托管站点打开它,可以使用上面的同一个 GitHub 链接获取项目文件并将它们上传到您的服务器。
## 🪟 在 Windows 上运行
websh 在您的浏览器中运行,因此您无需像启动普通桌面应用程序那样启动它。
在 Windows 上请按照以下流程操作:
1. 通过上面的链接下载项目
2. 解压文件
3. 将文件夹放入 Web 服务器文件夹中
4. 如果需要,启动您的服务器
5. 打开 Chrome、Edge 或 Firefox
6. 转到该应用程序的本地 Web 地址
7. 输入您的 SSH 主机、用户名和密码或密钥信息
8. 点击连接
如果您已经使用 XAMPP、WAMP、Laragon 或 Python Web 服务器等工具,您可以使用它们来提供这些文件。
## ✅ 前置条件
websh 专为简单的设置而设计。客户端只需一台带有浏览器的 Windows PC 即可。
要使 SSH 会话正常工作,您还需要:
- 一台远程 Linux 或 Unix 服务器
- 该服务器上的 SSH 访问权限
- 有效的用户名和密码,或 SSH 密钥
- 启用了 JavaScript 的浏览器
要托管该网页,您可以使用:
- 共享主机
- 小型 VPS
- 本地开发服务器
- 标准的 PHP 或 Python Web 服务器
## 🔧 首次设置
在将文件放到 Web 服务器上之后,在浏览器中打开该应用程序。
找到主连接表单。然后填写:
- 主机名或 IP 地址
- SSH 端口(如果不是默认端口 22)
- 用户名
- 密码或密钥信息
- 会话或终端设置(如有显示)
然后连接到您的远程机器。
如果您的服务器使用自定义端口,请在端口字段中输入该端口。如果您使用 SSH 密钥,并且应用程序提供了密钥字段或密钥导入选项,请使用该选项。
## 🧭 使用说明
当终端打开时,您可以像在正常的 SSH 会话中那样输入命令。
常见用途包括:
- 检查系统状态
- 读取日志文件
- 管理服务
- 编辑配置文件
- 移动文件
- 运行管理任务
您可以在任何带有浏览器的计算机上使用它,这使得它在您不想安装桌面 SSH 客户端时非常有用。
## 🌐 浏览器支持
websh 专为现代浏览器而构建。
使用:
- Google Chrome
- Microsoft Edge
- Mozilla Firefox
- Brave
为获得最佳效果,请保持您的浏览器处于最新状态。如果终端未打开或屏幕保持空白,请刷新页面并重试。
## ⚙️ 常见文件夹布局
典型的设置可能包括:
- 用于主页面的 `index.html`
- 用于终端逻辑的脚本文件
- 用于页面布局的样式文件
- 您的主机需要的小型后端文件(如果有)
- 用于终端视图的静态资源
由于该项目非常轻量,这些文件应该很容易放置在服务器上,并且以后也易于移动。
## 🔒 连接基础
当您连接到远程机器时,websh 会通过您设置的浏览器会话和服务器路径,将您的登录详细信息发送到该 SSH 主机。
请使用受信任的网络和您控制的服务器。
一些好习惯:
- 使用强密码
- 尽可能使用 SSH 密钥
- 保持您的服务器处于最新状态
- 使用专用连接进行管理工作
- 完成后关闭终端
## 🛠️ 故障排除
如果终端未加载:
- 检查文件是否在正确的 Web 文件夹中
- 刷新页面
- 尝试其他浏览器
- 确保 JavaScript 已开启
如果 SSH 连接失败:
- 检查主机名或 IP
- 检查端口号
- 确认用户名和密码
- 确保 SSH 在远程服务器上处于活动状态
- 检查您的服务器是否允许出站网络访问
如果页面已打开但终端没有响应:
- 重新加载页面
- 清除浏览器缓存
- 检查浏览器控制台是否存在脚本错误
- 验证您的托管计划是否允许所需的连接方法
如果您使用共享主机,您的主机可能会限制出站 SSH 访问。在这种情况下,请使用 VPS 或允许 SSH 访问的服务器。
## 🧩 websh 的实用场景
websh 非常适合在您需要 SSH 访问权限但不想使用本地应用程序的环境中使用。
适用的场景包括:
- 家庭实验室管理
- 服务器维护
- 远程支持
- 共享主机工具
- 工作或旅行时的基于浏览器的访问
- 磁盘空间不足的系统上的轻度管理使用
当您想要一个简单的页面而不是完整的桌面工具时,它也很有用。
## 📂 项目主题
该项目与以下内容相关:
browser, devops, lightweight, php, python, remote-access, self-hosted, shared-hosting, ssh, ssh-client, sysadmin, terminal, web-terminal, xterm, xterm-js, zero-dependencies
## 🧼 基本使用示例
一个简单的流程如下所示:
1. 在浏览器中打开应用程序
2. 输入您的服务器详细信息
3. 启动会话
4. 在终端中运行命令
5. 完成后结束会话
这同样是大多数 SSH 任务的模式。
## 📌 何时使用
在以下情况下请使用 websh:
- 基于浏览器的 SSH 访问
- 小型设置
- 客户端无需额外的安装步骤
- 在简单主机上也能良好运行的工具
- 在网页中清晰的终端视图
## 🧱 给 Windows 用户的注意事项
在 Windows 上,主要任务是通过本地或托管的 Web 路径在浏览器中打开应用程序。
如果你不确定将文件放在哪里,可以从以下位置之一开始:
- `C:\Users\\Downloads\websh`
- `C:\Users\\Documents\websh`
- 本地 Web 服务器根目录中的文件夹
然后从您的服务器工具中打开本地 URL,例如 `http://localhost/` 或服务器应用程序中显示的地址
## 📎 再次下载
如果您再次需要这些文件,请使用此链接:[https://github.com/Evildoerblockhouse900/websh](https://github.com/Evildoerblockhouse900/websh)
## 🧰 文件检查
下载后,请检查:
- 主页面文件
- 一个或多个支持文件
- 终端脚本或连接脚本
- 用于布局的样式文件
- 您的主机所需的任何服务器端文件
如果文件夹看起来不完整,请再次从上面的链接下载该项目并重新解压
标签:HTTP长轮询, Laragon, Linux管理, Python Web服务器, SSH客户端, WAMP, Web终端, XAMPP, 二进制发布, 共享主机, 多模态安全, 开源工具, 数据可视化, 无依赖, 浏览器终端, 纯前端, 自定义脚本, 轻量级应用, 远程执行, 远程管理, 远程访问, 逆向工具, 零构建