fin1ger/wetty

Wetty：浏览器中的终端（Web + tty）

镜像概述和主要用途

Wetty（Web + tty）是一款通过HTTP和HTTPS在浏览器中提供终端访问的工具。它作为Ajaxterm/Anyterm的替代方案，采用ChromeOS的hterm终端模拟器（纯JavaScript实现的完整终端模拟）和WebSocket通信，相比传统Ajax方案具有更快的响应速度和更完善的功能。

核心功能和特性

• hterm终端模拟：基于ChromeOS的hterm实现，提供完整的终端功能，支持各种终端命令和操作
• WebSocket通信：采用WebSocket而非Ajax，显著提升响应速度
• 多协议支持：同时支持HTTP和HTTPS协议，确保传输安全性
• 灵活连接方式：可连接本地或远程SSH服务器，支持指定SSH主机、端口和用户
• Nginx代理兼容：可通过Nginx反向代理部署，适合生产环境
• Docker化部署：提供Docker镜像，简化部署流程

使用场景和适用范围

• 远程服务器管理：通过浏览器便捷访问服务器终端
• 开发环境终端：在浏览器中直接操作开发环境终端
• 共享终端访问：团队成员通过浏览器共享终端会话
• 低资源环境：无需安装本地终端工具，直接通过浏览器使用

使用方法和配置说明

安装（非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 <主机名>、SSH端口：--sshport <端口>、SSH用户：--sshuser <用户名>
• 也可在地址栏指定SSH用户：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

注意：运行方式与HTTP模式相同，root用户启动/bin/login，普通用户启动SSH连接

通过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;
}

• 若以root用户运行app.js，访问地址：http://yourserver.com/wetty
• 若以普通用户运行app.js，访问地址：http://yourserver.com/wetty/ssh/<username>

注意：若Nginx已配置HTTPS，Wetty应禁用SSL运行

Docker化版本使用

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

• 访问地址：[localhost|$(boot2docker ip)]:3000
• 默认用户名：term，默认密码：term

作为服务守护进程运行

1. 全局安装Wetty：

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文件，例如：

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

配置参数说明