bachue/wetty

镜像概述和主要用途

该Docker镜像集成了Wetty和tmux工具，提供基于Web的终端访问解决方案。Wetty允许通过浏览器直接访问终端界面，而tmux作为终端复用器，支持在单个终端窗口中创建、管理多个会话，适用于需要通过Web界面进行远程终端操作并进行多任务管理的场景。

核心功能和特性

• Web终端访问：通过Wetty实现浏览器访问终端，无需本地终端工具
• tmux集成：内置tmux，支持会话创建、窗口分割、会话分离与重连等终端复用功能
• 便捷部署：容器化设计，一键启动，快速部署Web终端环境
• 跨平台兼容：支持任何具有浏览器的设备访问，不受操作系统限制

使用场景和适用范围

• 远程服务器管理：通过浏览器远程访问服务器终端，执行日常运维操作
• 多任务终端工作：利用tmux的会话管理功能，同时处理多个开发或运维任务
• 教学与演示：在浏览器中展示终端操作过程，方便教学演示或技术分享
• 快速开发环境：为开发人员提供包含tmux的Web终端环境，简化环境配置流程

使用方法和配置说明

基本使用（docker run）

通过以下命令启动容器，默认将容器8080端口映射到主机8080端口：

bash
docker run -d -p 8080:8080 --name wetty-tmux [镜像名称]

启动后，在浏览器中访问 http://localhost:8080 即可打开Web终端界面，直接使用tmux命令（如tmux new -s mysession创建新会话）。

自定义配置

端口映射调整

如需使用不同的主机端口，修改-p参数：

bash
docker run -d -p 8888:8080 --name wetty-tmux [镜像名称]

此时通过http://localhost:8888访问Web终端。

配置持久化

若需保存tmux配置或终端历史，可挂载本地目录：

bash
docker run -d -p 8080:8080 -v /本地路径:/root/.tmux.conf --name wetty-tmux [镜像名称]

环境变量配置（如支持）

如镜像支持用户认证等环境变量，可通过-e参数设置：

bash
docker run -d -p 8080:8080 -e USER=admin -e PASSWORD=secret --name wetty-tmux [镜像名称]

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  wetty-tmux:
    image: [镜像名称]
    ports:
      - "8080:8080"
    volumes:
      - ./tmux-config:/root/.tmux.conf  # 挂载本地tmux配置
    restart: always  # 容器退出后自动重启

执行docker-compose up -d启动服务。

注意事项

• 确保主机端口未被占用，避免端口冲突
• 首次使用tmux可通过tmux --help查看基本命令（如tmux attach重连会话）
• 生产环境建议配置HTTPS反向代理以保障访问安全