dockerhint/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主机、端口和用户
• Nginx反向代理兼容：可部署在Nginx反向代理之后使用
• Docker化部署：提供Docker镜像，简化部署流程

使用场景

• 远程服务器的浏览器端终端管理
• 开发环境的终端终端快速访问
• 无需安装本地终端工具的临时终端操作
• 团队共享的Web终端环境

使用方法

Docker部署

基本运行

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

访问地址：http://<服务器IP>:3000，默认用户名和密码均为term。

非Docker环境使用（参考）

HTTP模式运行

bash
node app.js -p 3000

• 若以root用户运行，将启动/bin/login（可指定用户名）
• 若以普通用户运行，默认连接localhost的SSH服务
• 可通过参数指定远程主机：--sshhost <主机> --sshport <端口> --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. 启动服务：

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

• 若以root用户运行app.js，访问地址：http://yourserver.com/wetty
• 若以普通用户运行，访问地址：http://yourserver.com/wetty/ssh/<username>
• 注意：若Nginx已配置HTTPS，Wetty应关闭SSL模式运行

注意事项

• 浏览器兼容性：仅支持Chrome浏览器，因hterm专为ChromeOS开发，Firefox可能无法正常工作
• 安全建议：生产环境中应始终使用HTTPS，避免明文传输终端数据
• Docker默认凭据：Docker镜像默认用户名/密码为term/term，生产环境应修改默认凭据以确保安全