spali/shellinabox

docker-shellinabox 镜像文档

镜像概述

docker-shellinabox是一个提供shellinabox的Docker容器，shellinabox是基于Web的AJAX终端模拟器。该镜像主要用于通过Web界面访问Docker主机及其容器，以便进行管理操作。

注意：在生产环境主机上使用此类容器可能会对Docker主机和容器带来安全风险。

核心功能与特性

• 提供基于Web的终端访问能力，无需安装额外客户端
• 支持通过环境变量自定义服务配置
• 可创建用户并配置权限（包括sudo权限）
• 支持安装额外Debian软件包
• 可禁用SSL，适用于置于代理后的场景

使用场景

• 开发环境中通过Web界面快速访问和管理Docker主机及容器
• 临时需要远程终端访问但无法使用传统SSH的场景
• 为团队提供统一的Web终端入口进行容器管理

使用方法与配置说明

可通过以下环境变量控制容器的预定义配置。如需定义自定义服务，请fork该仓库并将服务添加到shellinabox_services，容器脚本会自动解析新的变量名。

服务配置

SHELLINABOX_SERVICE_HOST

启用并定义Docker主机服务的URL路径。

SHELLINABOX_SERVICE_LOCAL

启用并定义本地容器服务的URL路径。

SHELLINABOX_SERVICE_WHO

启用并定义"who"服务的URL路径（显示当前连接用户）。

其他配置

SHELLINABOX_USER

若设置此变量，将自动创建指定用户。

SHELLINABOX_PASSWORD

为SHELLINABOX_USER指定的用户设置密码。若定义了用户但未设置密码，将默认拒绝登录（遵循Linux默认行为）。

SHELLINABOX_ALLOW_SUDO

设置为非空值时，会自动将SHELLINABOX_USER定义的用户添加到sudo组，允许切换至root。使用时需谨慎，大多数场景无需此配置，但可用于在容器内安装工具等操作。

SHELLINABOX_INSTALL_PKGS

设置为逗号分隔的Debian软件包名称列表，容器首次启动时会安装这些软件包。适用于在容器中安装vi等基础工具，以便用户在本地服务中使用。

SHELLINABOX_DEFAULT

设置默认服务，该服务将在Web服务器根路径可用。需设置为上述服务环境变量中的一个值。

SHELLINABOX_DISABLE_SSL

禁用shellinabox服务的SSL。适用于将容器置于代理后的场景。

部署示例

简单测试示例

启动一个测试容器，无实际服务定义：

bash
docker run -d --name shellinabox -p 4200:4200 -e SHELLINABOX_DISABLE_SSL=1 spali/shellinabox

完整示例

包含所有可能选项的示例：启动一个无SSL的容器，启用所有预定义服务（访问Docker主机、访问容器本身及"who"连接状态服务）：

bash
docker run -d --name shellinabox -p 4200:4200 \
  -e SHELLINABOX_SERVICE_HOST=host \
  -e SHELLINABOX_SERVICE_WHO=who \
  -e SHELLINABOX_SERVICE_LOCAL=local \
  -e SHELLINABOX_ALLOW_SUDO=1 \
  -e SHELLINABOX_USER=myuser \
  -e SHELLINABOX_PASSWORD=mypassword \
  -e SHELLINABOX_DISABLE_SSL=1 \
  -e SHELLINABOX_DEFAULT=host \
  spali/shellinabox