haxagon/workstation

远程工作站Docker镜像

镜像概述和主要用途

用于创建用户可连接的基础容器镜像模板，是一个可通过环境变量轻松配置的简单服务器。用户可通过SSH或Web控制台远程访问，并支持自定义启动行为，适用于构建灵活的容器工作站环境。

核心功能和特性

• 灵活的远程访问配置：支持SSH服务器、Web控制台（带自定义端口）及用户基础设置（用户名、密码、默认shell、sudo权限）
• 自定义入口脚本：可指定启动时执行的脚本路径，支持自动移除、调试模式及执行状态标识输出
• 环境变量驱动配置：所有功能均通过环境变量控制，无需修改镜像即可调整容器行为

使用场景和适用范围

• 开发环境：快速部署带远程访问的开发工作站
• 培训/教学场景：为学员提供统一配置的远程操作环境
• 演示环境：构建可临时访问的容器化操作平台
• 自动化任务：通过自定义入口脚本实现容器启动时的自动化配置

使用方法和配置说明

环境变量配置

远程访问配置

入口脚本配置

Docker部署示例

基础远程工作站（SSH访问）

bash
docker run -d \
  -e ENABLE_SSH=true \
  -e USERNAME=devuser \
  -e PASSWORD=securepass \
  -e SUDO=true \
  -p 2222:22 \
  --name remote-workstation \
  [镜像名称]

带Web控制台的工作站

bash
docker run -d \
  -e WEB_SHELL=true \
  -e WEB_SHELL_PORT=8080 \
  -e USERNAME=webuser \
  -e SHELL=/bin/zsh \
  -p 8080:8080 \
  --name web-workstation \
  [镜像名称]

自定义入口脚本

bash
# 本地创建入口脚本 entrypoint.sh
cat > entrypoint.sh << 'EOF'
#!/bin/bash
echo "Custom initialization..."
mkdir -p /workspace
EOF
chmod +x entrypoint.sh

# 启动容器并挂载脚本
docker run -d \
  -v $(pwd)/entrypoint.sh:/tmp/entrypoint.sh \
  -e ENTRYPOINT_PATH=/tmp/entrypoint.sh \
  -e ENTRYPOINT_REMOVE=false \
  --name custom-entrypoint-workstation \
  [镜像名称]

注：将上述示例中的[镜像名称]替换为实际使用的Docker镜像名称。