zhezack/shellinabox

shellinabox Docker镜像文档

概述

shellinabox Docker镜像是基于Alpine Linux构建的轻量级容器，提供通过Web浏览器访问shell的功能。用户可通过HTTP/HTTPS协议连接容器内的命令行环境，支持自定义用户账户、访问端口、SSL加密等配置，适用于远程管理、开发调试及临时命令行操作场景。

核心功能与特性

• 轻量级：基于Alpine Linux，镜像体积小，资源占用低
• Web访问：通过浏览器直接访问容器内shell，无需额外客户端
• 灵活配置：支持通过环境变量自定义用户、端口、SSL等参数
• 用户管理：可自动创建用户，支持自定义用户名、ID、密码及权限
• 扩展能力：支持预装额外软件包和执行启动脚本
• 安全选项：默认启用SSL加密，可根据需求禁用

使用场景

• 远程管理容器内命令行环境
• 开发调试过程中的临时shell访问
• 教学演示或共享命令行操作环境
• 轻量级Web-based终端服务部署

配置说明

环境变量

以下环境变量可用于配置容器行为：

使用示例

Docker Run 命令

基本运行（默认配置）

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

首次运行时，自动生成的密码会输出到容器日志，可通过docker logs shellinabox查看

自定义用户和密码

bash
docker run -d -p 8080:4200 \
  -e SIAB_USER=myuser \
  -e SIAB_PASSWORD=mypassword \
  -e SIAB_PORT=4200 \
  --name shellinabox zhezack/shellinabox

禁用SSL（使用HTTP）

bash
docker run -d -p 80:4200 \
  -e SIAB_SSL=false \
  --name shellinabox zhezack/shellinabox

安装额外软件包

bash
docker run -d -p 4200:4200 \
  -e SIAB_PKGS="curl wget vim" \
  --name shellinabox zhezack/shellinabox

Docker Compose 配置

yaml
version: '3'
services:
  shellinabox:
    image: zhezack/shellinabox
    ports:
      - "4200:4200"
    environment:
      - SIAB_USER=admin
      - SIAB_PASSWORD=securepassword
      - SIAB_SUDO=true
      - SIAB_PKGS=git python3
      - SIAB_PORT=4200
    restart: unless-stopped

访问方法

启动容器后，通过浏览器访问 http://<容器IP>:<映射端口> 或 https://<容器IP>:<映射端口>（若启用SSL），输入配置的用户名和密码即可登录shell界面。