ksyun/wetty

Wetty 镜像文档

镜像概述

Wetty（Web + tty）是一款通过HTTP/HTTPS在浏览器中提供终端访问的工具，作为Ajaxterm/Anyterm的替代方案，具有更优的性能和功能。它采用ChromeOS的hterm终端模拟器（纯JavaScript实现的完整终端模拟），并使用WebSockets替代传统Ajax技术，显著提升响应速度。

核心功能和特性

• 完整终端模拟：集成ChromeOS的hterm终端模拟器，支持完整的终端功能
• 高效通信：使用WebSockets替代Ajax，提供更低延迟和更好的响应性能
• 多协议支持：同时支持HTTP和HTTPS访问
• 灵活连接：可连接本地或远程SSH服务器，支持指定SSH主机、端口和用户
• 反向代理兼容：可通过Nginx等反向代理部署
• Docker化部署：提供Docker镜像，简化部署流程

使用场景和适用范围

• 远程服务器管理：通过浏览器便捷访问服务器终端
• 开发环境访问：无需本地终端工具，直接在浏览器中操作开发环境
• 受限网络环境：通过HTTP/HTTPS协议穿透防火墙访问终端
• 多用户共享终端：通过Nginx代理实现多用户安全访问

使用方法和配置说明

Docker部署

基本运行

bash
docker run --name term -p 3000:3000 -dt nathanleclaire/wetty

访问方式：在浏览器中访问 http://<服务器IP>:3000，默认用户名为 term，密码为 term。

非Docker环境运行（源码方式）

安装

bash
git clone https://github.com/krishnasrinivas/wetty
cd wetty
npm install

HTTP模式运行

bash
node app.js -p 3000

• 若以root用户运行：启动 /bin/login（可指定用户名）
• 若以普通用户运行：默认SSH连接到 localhost
• 连接远程主机：可使用 --sshhost（指定主机）、--sshport（指定端口）、--sshuser（指定用户）参数
• 通过URL指定用户：http://yourserver:3000/wetty/ssh/<username>

HTTPS模式运行

1. 生成自签名证书（若无CA证书）：

   bash
   openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 30000 -nodes
   

2. 启动HTTPS服务：

   bash
   node app.js --sslkey key.pem --sslcert cert.pem -p 3000
   

Nginx反向代理配置

在Nginx配置文件中添加：

nginx
location /wetty {
    proxy_pass http://127.0.0.1:3000/wetty;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 43200000;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_set_header X-NginX-Proxy true;
}

• 若Nginx已配置HTTPS，Wetty应使用HTTP模式运行
• 访问地址：
  • root用户运行：http://yourserver.com/wetty
  • 普通用户运行：http://yourserver.com/wetty/ssh/<username>

作为服务守护进程运行

1. 全局安装：

   bash
   sudo npm install wetty -g
   

2. 配置服务：

   bash
   sudo cp /usr/local/lib/node_modules/wetty/bin/wetty.conf /etc/init
   

3. 启动服务：

   bash
   sudo start wetty
   

默认在3000端口运行，如需修改端口或重定向日志，编辑 /etc/init/wetty.conf 文件，例如：

bash
exec sudo -u root wetty -p 80 >> /var/log/wetty.log 2>&1