roul76/wetty

docker-webconsole 镜像文档

镜像概述

docker-webconsole是一个运行WeTTy的Docker容器，WeTTy是一款基于Web的终端工具，允许用户通过浏览器访问容器内的终端界面。该镜像默认配置了用户、密码和shell，并支持通过环境变量自定义这些参数，同时具备动态更新hosts文件的功能。

核心功能与特性

• 默认配置：预配置用户wetty、密码wetty和shell/bin/sh
• 自定义参数：支持通过环境变量覆盖默认用户、密码和shell
• 密码安全：支持使用openssl生成密码哈希值
• 动态hosts更新：持续监控/webconsole/hosts文件，文件内容变更后1秒内自动同步至/etc/hosts

使用场景

• 需通过Web界面访问容器终端的场景
• 远程管理Docker容器的终端操作
• 开发或测试环境中需要快速配置终端访问的场景
• 需要动态管理容器内hosts解析的场景

使用方法与配置说明

基本使用

默认配置下运行容器：

bash
docker run -d -p 3000:3000 docker.xuanyuan.run/roul76/wetty:latest

访问 http://localhost:3000 即可通过浏览器打开Web控制台，使用默认用户wetty和密码wetty登录。

自定义配置

通过环境变量覆盖默认参数：

bash
docker run -d -p 3000:3000 \
  -e WEBCONSOLE_USER='自定义用户名' \
  -e WEBCONSOLE_PASSWORD='密码哈希值' \
  -e WEBCONSOLE_SHELL='自定义shell路径' \
  docker.xuanyuan.run/roul76/wetty:latest

密码哈希生成

使用openssl生成密码哈希值（推荐使用MD5加密方式）：

bash
openssl passwd -1 '你的明文密码'

执行后会输出加密后的哈希值，将其作为WEBCONSOLE_PASSWORD环境变量的值。

hosts文件管理

容器会持续监控/webconsole/hosts文件，可通过挂载卷的方式提供自定义hosts内容：

bash
docker run -d -p 3000:3000 \
  -v /本地/hosts文件路径:/webconsole/hosts \
  docker.xuanyuan.run/roul76/wetty:latest

当/webconsole/hosts文件内容更新时，容器会在1秒内自动更新/etc/hosts文件。