butlerx/wetty

WeTTy Docker镜像文档

概述

WeTTy（Web + TTY）是一款通过HTTP/HTTPS在浏览器中提供终端访问的工具，作为ajaxterm和anyterm的替代方案，其核心优势在于采用xterm.js实现完整的终端模拟功能，并使用WebSocket替代Ajax通信，从而提供更优的响应性能。

注意：本Docker镜像已弃用，建议使用最新镜像 wettyoss/wetty。

核心功能与特性

• 完整终端模拟：基于xterm.js实现全功能终端仿真，支持标准终端操作
• 高效通信：采用WebSocket协议，相比传统Ajax技术具有更低的延迟
• 多协议支持：同时支持HTTP和HTTPS协议
• 灵活连接：可连接本地终端或远程SSH服务器
• 用户友好：支持预指定用户名登录（通过URL路径 http://yourserver:3000/wetty/ssh/<username>）

前提条件

• Docker引擎版本 >= 1.13.0
• 网络环境允许访问容器暴露的端口（默认3000）

使用方法

基本运行

bash
docker run -d -p 3000:3000 wetty

访问 http://<your-server-ip>:3000/wetty 即可打开终端登录界面。

指定SSH服务器

bash
docker run -d -p 3000:3000 \
  -e SSH_HOST=remote.example.com \
  -e SSH_PORT=22 \
  -e SSH_USER=defaultuser \
  wetty

启用HTTPS

bash
docker run -d -p 3000:3000 \
  -v /path/to/ssl/key.pem:/ssl/key.pem \
  -v /path/to/ssl/cert.pem:/ssl/cert.pem \
  wetty --sslkey /ssl/key.pem --sslcert /ssl/cert.pem

配置参数

使用场景

• 远程服务器管理：通过浏览器安全访问服务器终端
• 开发环境集成：作为Web应用的终端组件
• 教学演示：在线展示命令行操作
• 受限环境访问：在仅允许HTTP/HTTPS的网络中提供终端访问

浏览器支持

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

• Chrome (最新版)
• Firefox (最新版)
• Safari (最新版)
• Edge (最新版)

注意事项

• 弃用提示：本镜像已不再维护，建议迁移至官方最新镜像 wettyoss/wetty
• 生产环境中建议启用HTTPS以确保通信安全
• 高并发场景下需合理配置资源限制

相关文档

• https://github.com/butlerx/wetty/tree/master/docs
• https://github.com/butlerx/wetty/blob/master/docs/ssl.md
• https://github.com/butlerx/wetty/blob/master/docs/service.md