wettyoss/wetty

WeTTY：Web浏览器中的终端访问工具

镜像概述

WeTTY（Web + TTY）是一款通过HTTP/HTTPS协议在浏览器中提供终端访问的工具。它使用xterm.js实现完整的终端仿真功能，通过websockets而非传统Ajax技术实现通信，因此具有更低的响应延迟。相比ajaxterm和anyterm等同类工具，WeTTY提供更完善的终端体验和更优的性能表现。

核心功能与特性

• 完整终端仿真：基于xterm.js实现，支持标准终端的所有功能
• 低延迟通信：采用websockets技术，响应速度优于传统Ajax方案
• SSH连接支持：可连接本地或远程SSH服务器，支持密码和公钥认证
• 灵活配置选项：支持自定义端口、主机、认证方式等多种参数
• 浏览器兼容性：兼容所有xterm.js支持的浏览器
• HTTPS支持：可配置SSL证书实现安全加密通信

使用场景与适用范围

• 远程服务器管理：无需本地终端软件，通过浏览器即可访问服务器终端
• 临时终端访问：在无法安装终端软件的环境中提供终端功能
• 团队协作：共享终端会话，支持协作调试和操作
• 嵌入式设备管理：通过浏览器管理无显示器的嵌入式设备
• 教学演示：实时展示终端操作过程

前置要求

• Docker环境（1.13.0+）
• 网络连接（用于拉取镜像和通信）

使用方法

基本使用

使用默认配置启动WeTTY容器：

bash
docker run -d -p 3000:3000 --name wetty butlerx/wetty

启动后，在浏览器中访问 http://<服务器IP>:3000/wetty 即可看到登录界面。

连接远程SSH服务器

指定远程SSH服务器信息启动：

bash
docker run -d -p 3000:3000 --name wetty \
  butlerx/wetty \
  --ssh-host=remote.example.com \
  --ssh-port=22 \
  --ssh-user=defaultuser

使用HTTPS加密

挂载SSL证书并启用HTTPS：

bash
docker run -d -p 3000:3000 --name wetty \
  -v /path/to/ssl-key.pem:/ssl/key.pem \
  -v /path/to/ssl-cert.pem:/ssl/cert.pem \
  butlerx/wetty \
  --ssl-key=/ssl/key.pem \
  --ssl-cert=/ssl/cert.pem

指定登录用户

直接访问 http://<服务器IP>:3000/wetty/ssh/<用户名> 可预先指定登录用户，例如： http://192.168.1.100:3000/wetty/ssh/admin

配置参数说明

常见问题

支持哪些浏览器？

WeTTY支持所有xterm.js兼容的浏览器，包括：

• Chrome/Chromium 49+
• Firefox 45+
• Edge 14+
• Safari 10+

如何实现自动登录？

可通过配置文件或命令行参数预先设置SSH用户名和密码（不推荐生产环境使用明文密码）：

bash
docker run -d -p 3000:3000 --name wetty \
  butlerx/wetty \
  --ssh-host=remote.example.com \
  --ssh-user=autouser \
  --ssh-pass=autopassword

如何将WeTTY作为服务运行？

可使用Docker Compose实现持久化部署，创建docker-compose.yml：

yaml
version: '3'
services:
  wetty:
    image: butlerx/wetty
    ports:
      - "3000:3000"
    volumes:
      - ./ssl:/ssl
    command: --ssl-key=/ssl/key.pem --ssl-cert=/ssl/cert.pem --ssh-host=server.internal
    restart: always

启动服务：docker-compose up -d

相关文档

• https://github.com/butlerx/wetty/tree/master/docs
• https://github.com/butlerx/wetty/blob/master/docs/service.md
• https://github.com/butlerx/wetty/blob/master/docs/https.md
• https://github.com/butlerx/wetty/blob/master/docs/downloading-files.md