freeflyer/wetty

Wetty Docker 镜像文档

镜像概述

Wetty是一个通过HTTP和HTTPS提供终端访问的工具，作为ajaxterm/anyterm的替代方案，其优势在于使用ChromeOS的hterm终端模拟器（完全基于JavaScript实现的完整终端模拟）和WebSocket通信（相比Ajax具有更优的响应速度）。

原始版本：https://github.com/krishnasrinivas/wetty
hterm源码：[***]

!https://github.com/freeeflyer/wetty/raw/master/terminal.png?raw=true

核心功能与特性

• 完整终端模拟：基于hterm实现，支持完整的终端功能
• 高效通信：采用WebSocket而非Ajax，响应速度更快
• Docker化部署：提供Docker镜像，简化部署流程
• 用户认证：支持通过环境变量配置用户和密码哈希

使用场景

• 远程服务器终端访问（通过浏览器）
• 开发环境的Web化终端管理
• 需要通过HTTP/HTTPS协议提供终端服务的场景

使用方法

基本部署（Docker Run）

bash
docker run --name term -e WETTY_USER=your_user -e WETTY_HASH='<your hash between simple quotes>' -p 3000:3000 -dt freeflyer/wetty

环境变量说明

• WETTY_USER：登录用户名（可选，默认值：term）
• WETTY_HASH：密码哈希值（可选，默认值对应密码"term"）

生成密码哈希

哈希值必须用单引号包裹，否则特殊字符可能导致截断。生成方法：

bash
mkpasswd -m sha-512 -S <your_salt> <<< <yourpass>

或直接从/etc/shadow文件中复制现有用户的哈希值。

Docker Compose 配置

推荐在代理后使用（尤其是HTTPS环境），以下示例绑定本地回环地址：

yaml
wetty:
  image: freeflyer/wetty
  environment:
    - WETTY_USER=your_user
    - WETTY_HASH=<your hash between simple quotes>
  ports:
    - "127.0.0.1:3000:3000"
  networks:
    - front

代理配置

注意事项

• 若以root用户运行app.js，访问URL为：http://yourserver.com/wetty
• 若以普通用户运行app.js，访问URL为：http://yourserver.com/wetty/ssh/<username>
• 若代理已配置HTTPS，Wetty应禁用SSL运行

Traefik 代理

推荐使用Traefik作为代理，与Docker集成良好。在swarm/docker-compose中添加以下部署标签：

yaml
deploy:
  labels:
    - "traefik.domain=your-hostname"
    - "traefik.backend=wetty"
    - "traefik.enable=true"
    - "traefik.port=3001"
    - "traefik.frontend.entryPoints=https,http"
    - "traefik.frontend.redirect.entryPoint=https"
    - "traefik.frontend.redirect.permanent=true"
    - "traefik.frontend.rule=Host:<your-hostname>"
    - "traefik.docker.network=<your-docker-network-name>"

此配置为Wetty分配独立域名，启用HTTPS并将HTTP请求重定向至HTTPS。更多信息：[***]

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

Apache 代理

Apache代理配置示例：

Apache
ProxyPass /wetty http://127.0.0.1:3000/wetty
ProxyPassReverse /wetty http://127.0.0.1:3000/wetty
<Location /wetty>
    # Apache 2.4+ 认证配置，详见 http://httpd.apache.org/docs/2.4/upgrading.html#run-time
    AuthUserFile /etc/apache2/xmisspasswd
    AuthType Basic
    AuthName "WTF"
    Require valid-user
</Location>

最新变更

• 基于node:alpine镜像构建，减小镜像体积

待办事项

• 添加supervisord或其他进程监控工具
• （理想功能）开发支持SSH密钥登录的浏览器插件