berryk/wetty

Wetty 镜像文档

镜像概述

Wetty（Web + tty）是一个通过HTTP和HTTPS提供终端访问的工具，是ajaxterm/anyterm的替代方案。它采用ChromeOS的hterm终端模拟器（纯JavaScript实现的完整终端仿真），并使用websockets而非Ajax，因此响应速度更快。本镜像为Wetty的分支版本，支持将主机作为URL的一部分进行访问。

核心功能与特性

• hterm终端模拟：集成ChromeOS的hterm，提供完整的终端仿真功能
• Websockets通信：相比传统Ajax技术，响应速度更快，交互更流畅
• URL参数支持：可在URL中指定主机、用户名等信息，如http://yourserver:3000/wetty/ssh/<username>
• 多协议支持：同时支持HTTP和HTTPS访问
• 灵活部署：可直接运行、通过Nginx代理、Docker容器化部署或作为系统服务运行

使用场景与适用范围

• 远程服务器的浏览器端终端管理
• 开发/运维环境的快速终端访问
• 需要通过Web界面提供终端功能的应用场景
• 低延迟要求的Web终端交互场景

使用方法与配置说明

基本运行方式

HTTP模式运行

bash
node app.js -p 3000

• 若以root用户运行，将启动/bin/login（可指定用户名）
• 若以普通用户运行，默认通过SSH连接到localhost
• 可通过参数指定远程主机：
  • --sshhost：指定SSH主机
  • --sshport：指定SSH端口
  • --sshuser：指定SSH用户

HTTPS模式运行

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

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

2. 使用SSL证书运行：

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

Docker部署

基本运行

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

• 访问地址：http://[localhost|服务器IP]:3000
• 默认用户名：term
• 默认密码：term

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无需启用SSL。

访问方式：

• root用户运行app.js：http://yourserver.com/wetty
• 普通用户运行app.js：http://yourserver.com/wetty/ssh/<username>

作为系统服务运行

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文件，修改最后一行：

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

配置参数说明