wrfly/container-web-tty

容器Web TTY镜像文档

1. 镜像概述

本镜像旨在提供通过Web浏览器访问容器终端（TTY）的功能，无需本地安装终端工具或通过SSH连接容器，直接通过Web界面实现容器命令行交互，适用于需要便捷管理容器终端的场景。

2. 核心功能与特性

• Web界面访问：通过浏览器即可访问容器终端，无需额外终端工具
• 命令行交互：支持完整的容器命令行操作，包括输入命令、查看输出、历史命令记录
• 跨平台兼容：兼容主流浏览器（Chrome、Firefox、Edge等）
• 轻量部署：镜像体积小，部署简单，无需复杂配置

3. 使用场景

• 远程管理容器：无需本地终端工具，通过Web浏览器远程操作容器命令行
• 简化终端访问：适用于无SSH权限或本地终端配置复杂的环境
• 教学/演示场景：方便共享容器终端操作过程，支持多人查看

4. 使用方法

4.1 基本部署（docker run）

bash
docker run -d -p 8080:8080 --name web-tty --privileged -v /var/run/docker.sock:/var/run/docker.sock your-image-name:tag

参数说明：

• -p 8080:8080：端口映射，将容器内8080端口映射到主机8080端口（可根据需求修改主机端口）
• --privileged：赋予容器访问Docker守护进程的权限（必要时添加，用于获取容器列表）
• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程套接字，使镜像能识别宿主机容器

4.2 访问Web界面

部署完成后，通过浏览器访问 http://<主机IP>:8080 即可打开Web终端界面，选择目标容器后进入命令行交互页面。

4.3 环境变量配置

带认证的部署示例：

bash
docker run -d -p 8080:8080 \
  -e AUTH_ENABLED=true \
  -e AUTH_USER=admin \
  -e AUTH_PASSWORD=SecurePass123 \
  --name web-tty \
  -v /var/run/docker.sock:/var/run/docker.sock \
  your-image-name:tag

5. 注意事项

• 挂载/var/run/docker.sock可能带来安全风险，建议仅在可信环境中使用
• 生产环境中建议启用认证功能（AUTH_ENABLED=true）并使用强密码
• 确保主机端口未被占用，或通过修改-p参数指定其他端口