noisy/wetty

Wetty 镜像文档

镜像概述

Wetty（Web + tty）是一款通过HTTP和HTTPS提供终端访问的工具，作为ajaxterm/anyterm的替代方案，其核心优势在于采用ChromeOS的hterm终端模拟器（纯JavaScript实现的完整终端模拟）和WebSockets通信，相比传统Ajax技术具有更优的响应速度。

核心功能与特性

• 完整终端模拟：基于hterm实现，支持完整的终端功能
• WebSockets通信：相比Ajax技术，提供更低延迟和更好的响应性
• 多协议支持：可通过HTTP或HTTPS运行
• SSH集成：支持连接本地或远程SSH服务器
• 灵活部署：可直接运行、通过Nginx代理或Docker容器化部署

使用场景

• 远程服务器的Web-based终端管理
• 无需安装本地终端工具的临时终端访问
• 开发环境中的快速终端共享
• 低延迟的Web终端交互需求

使用方法与配置说明

Docker部署示例

基本运行

使用以下命令启动Wetty容器：

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

• --name term：指定容器名称为term
• -p 3000:3000：将容器的3000端口映射到主机的3000端口
• -dt：后台运行并分配伪终端

访问方式

在浏览器中访问以下URL：

• 本地运行：http://localhost:3000
• 使用boot2docker：http://$(boot2docker ip):3000

默认登录凭据：

• 用户名：term
• 密码：term

高级配置

自定义SSH连接

若需连接远程SSH服务器，可在启动时指定参数（非Docker环境）：

bash
node app.js --sshhost <远程主机> --sshport <端口> --sshuser <用户名>

或在URL中指定用户名：http://yourserver:3000/wetty/ssh/<username>

HTTPS运行

建议使用HTTPS确保安全。若没有CA证书，可生成自签名证书：

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

然后运行（非Docker环境）：

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

Nginx代理配置

若需通过Nginx代理Wetty，添加以下配置到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应关闭SSL运行。

作为服务运行

（非Docker环境）全局安装并作为服务运行：

bash
sudo npm install wetty -g
sudo cp /usr/local/lib/node_modules/wetty/bin/wetty.conf /etc/init
sudo start wetty

默认在3000端口运行，可修改wetty.conf调整端口和日志输出：

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