fhuegli/shellinabox

docker-shellinabox

镜像概述和主要用途

基于Alpine Linux的轻量级Docker镜像，集成shellinabox服务，允许通过Web浏览器访问容器内的shell环境。无需SSH客户端，直接通过网页界面进行命令行操作，适用于远程管理、开发调试等场景。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 灵活用户配置：支持自定义用户名、ID、密码、shell类型及主目录
• 安全访问：默认启用SSL并自动生成证书，保障Web传输安全
• 可扩展性：支持预装系统包（SIAB_PKGS）和运行启动脚本（SIAB_SCRIPT）
• 权限控制：可配置sudo权限，灵活管理用户操作范围
• 端口自定义：支持指定监听端口，适应不同网络环境需求

使用场景和适用范围

• 远程服务器/容器的Web-based命令行管理
• 开发环境中快速访问容器内部shell
• 教学或演示场景下提供Web界面的命令行操作
• 受限网络环境中替代SSH的Web shell访问方案

使用方法和配置说明

环境变量配置

通过以下环境变量自定义镜像行为：

Docker部署示例

基本运行命令

bash
docker run -d -p 4200:4200 --name shellinabox fhuegli/shellinabox

启动后通过浏览器访问 https://<主机IP>:4200，默认用户为guest，密码可通过容器日志获取：docker logs shellinabox

自定义用户与权限配置

bash
docker run -d -p 8080:4200 \
  -e SIAB_USER=admin \
  -e SIAB_PASSWORD=SecurePass123! \
  -e SIAB_SUDO=true \
  -e SIAB_SHELL=/bin/sh \
  --name secure-shell fhuegli/shellinabox

此配置将：

• 映射主机8080端口到容器4200端口
• 创建用户admin，密码SecurePass123!
• 授予sudo权限，使用/bin/sh作为shell

docker-compose配置示例

yaml
version: '3'
services:
  shellinabox:
    image: fhuegli/shellinabox
    ports:
      - "4200:4200"
    environment:
      - SIAB_USER=devuser
      - SIAB_PASSWORD=dev@Pass2024
      - SIAB_PKGS=vim curl wget
      - SIAB_SSL=true
      - SIAB_SERVICE="/:LOGIN /test:guest:guest:/home/guest:/bin/bash"
    restart: unless-stopped

此配置将预装vim、curl、wget工具，定义两个访问端点，并设置自动重启策略。

注意事项

• 生产环境建议显式设置SIAB_PASSWORD，避免依赖自动生成密码
• 禁用SSL（SIAB_SSL=false）时使用http协议访问，仅建议在可信网络环境中使用
• 安装额外包时需使用Alpine Linux包管理系统的包名（如"vim"而非"vim-enhanced"）
• 启动脚本（SIAB_SCRIPT）应确保可从指定URL下载且具有可执行权限