researchiteng/wetty

Wetty Docker镜像文档

镜像概述

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

核心功能与特性

• hterm终端仿真：集成ChromeOS的hterm，提供完整的终端功能，支持各种终端命令和交互
• Websockets通信：采用websockets替代Ajax，降低延迟，提升响应速度
• 多协议支持：同时支持HTTP和HTTPS访问，满足不同安全需求
• 灵活的SSH连接：可连接本地或远程SSH服务器，支持指定SSH主机、端口和用户
• Docker化部署：提供Docker镜像，简化部署流程，支持容器化运行

使用场景

• 远程服务器管理：通过浏览器安全访问服务器终端
• 开发环境集成：在Web界面中嵌入终端功能
• 低延迟终端访问：需要快速响应的终端操作场景
• 跨平台终端访问：无需安装本地终端工具，通过浏览器即可访问

使用方法

Docker快速启动

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

访问地址：http://<服务器IP>:3000
默认登录凭据：用户名 term，密码 term

配置参数说明

基础运行参数

• -p <端口>：指定服务端口（默认3000）
• --sslkey <路径>：SSL私钥文件路径（HTTPS模式）
• --sslcert <路径>：SSL证书文件路径（HTTPS模式）
• --sshhost <主机>：指定SSH连接的远程主机
• --sshport <端口>：指定SSH连接端口
• --sshuser <用户>：指定SSH连接用户

通过URL指定SSH用户

可在访问URL中直接指定SSH用户：

http://yourserver:3000/wetty/ssh/<username>

HTTPS配置

生成自签名证书

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

Docker中运行HTTPS模式

bash
docker run --name term -p 3000:3000 -v $(pwd)/key.pem:/key.pem -v $(pwd)/cert.pem:/cert.pem -dt nathanleclaire/wetty 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无需启用SSL，直接使用HTTP模式即可。

作为服务运行

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

4. 自定义配置（修改/etc/init/wetty.conf）：

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

（上述示例修改端口为80，并将日志输出到/var/log/wetty.log）

注意事项

• 以root用户运行时，Wetty会启动/bin/login允许用户输入用户名；非root用户运行时，默认连接本地SSH
• 生产环境建议使用HTTPS模式或通过HTTPS的Nginx代理，确保通信安全
• Docker容器默认提供的term/term凭据仅用于测试，生产环境应修改为强密码或集成认证系统