lblazewski/wetty

Wetty Docker镜像文档

镜像概述

Wetty（Web + TTY）是一款基于Web的终端工具，本Docker镜像针对多种架构（如amd64、arm64等）构建，提供跨平台的Web终端访问能力。用户可通过浏览器直接操作终端，无需安装额外客户端，适用于远程服务器管理、开发环境访问等场景。

核心功能与特性

• 多架构支持：兼容amd64、arm64等主流硬件架构，可在x86服务器、ARM开发板等不同设备上运行
• Web终端访问：通过浏览器即可访问终端，支持标准终端操作（命令输入、输出显示、快捷键等）
• 轻量级设计：基于精简基础镜像构建，资源占用低，启动速度快
• 灵活配置：支持通过环境变量自定义端口、用户认证等参数
• 易于集成：可快速部署到Docker、Kubernetes等容器化环境

使用场景

• 远程服务器管理：无需SSH客户端，通过浏览器远程操作服务器
• 开发环境统一入口：为团队提供统一的Web终端访问开发环境
• 跨平台终端需求：在不同架构设备（如树莓派、云服务器）上提供一致的终端体验
• 嵌入式设备管理：为ARM架构的嵌入式设备提供便捷的Web终端管理方式

使用方法

基本部署（docker run）

bash
docker run -d -p 3000:3000 --name wetty ***-ghcr.xuanyuan.run/butlerx/wetty:latest

• -p 3000:3000：映射容器3000端口到主机3000端口（Wetty默认端口）
• --name wetty：指定容器名称为wetty

自定义配置

1. 修改访问端口

bash
docker run -d -p 8080:3000 --name wetty ***-ghcr.xuanyuan.run/butlerx/wetty:latest

将主机端口修改为8080，通过http://localhost:8080访问

2. 设置基本认证

bash
docker run -d -p 3000:3000 \
  -e WETTY_USER=admin \
  -e WETTY_PASSWORD=yourpassword \
  --name wetty ***-ghcr.xuanyuan.run/butlerx/wetty:latest

• WETTY_USER：登录用户名
• WETTY_PASSWORD：登录密码

3. 持久化终端配置

bash
docker run -d -p 3000:3000 \
  -v /path/to/local/.bashrc:/root/.bashrc \
  --name wetty ***-ghcr.xuanyuan.run/butlerx/wetty:latest

挂载本地.bashrc文件，保持终端配置持久化

Docker Compose配置

yaml
version: '3'
services:
  wetty:
    image: ***-ghcr.xuanyuan.run/butlerx/wetty:latest
    ports:
      - "3000:3000"
    environment:
      - WETTY_USER=admin
      - WETTY_PASSWORD=securepassword
    volumes:
      - ./terminal-config:/root
    restart: unless-stopped

• volumes：挂载本地目录保存终端配置（如.bash_history、.bashrc等）
• restart: unless-stopped：容器退出时自动重启

环境变量说明

架构支持

该镜像支持以下架构：

• amd64：适用于x86_64架构设备（如普通PC、云服务器）
• arm64：适用于ARM64架构设备（如树莓派4、ARM服务器）
• armv7：适用于ARM32架构设备（如树莓派3）

可通过指定标签选择特定架构，例如：ghcr.io/butlerx/wetty:latest-arm64