simple-workstation 镜像文档

一、镜像概述

simple-workstation 是一个轻量级个人工作站 Docker 镜像，专为个人日常开发、学***及轻量级任务处理设计。该镜像集成基础系统工具、开发环境依赖及常用命令行工具，提供开箱即用的交互式工作环境，支持用户自定义配置，适用于快速搭建一致的个人工作空间。

二、核心功能与特性

2.1 基础工具集成

• 系统工具：bash、zsh、curl、wget、ssh、sudo
• 开发工具：git（版本控制）、vim（文本编辑）、python3（基础脚本运行）、gcc（基础编译）
• 网络工具：ping、netcat、telnet、dig（网络诊断）

2.2 环境定制能力

• 支持自定义用户名及用户权限（默认 root 用户，可通过环境变量切换普通用户）
• 集成 bashrc/zshrc 基础配置，支持挂载用户自定义配置文件
• 时区动态配置（默认 UTC，可通过环境变量指定时区）

2.3 数据持久化

• 支持本地目录挂载（如工作目录、配置文件目录），确保容器重启后数据不丢失
• 内置数据卷路径 /workspace，用于存放核心工作文件

2.4 轻量级设计

• 基于 Alpine 或 Debian Slim 基础镜像构建，镜像体积小于 500MB
• 无冗余服务进程，仅保留必要工具，资源占用低

三、使用场景与适用范围

3.1 个人开发环境

• 快速搭建临时开发环境（如脚本编写、小型项目测试）
• 跨平台开发环境一致性保障（避免因操作系统差异导致的工具版本问题）

3.2 学***与实验环境

• 编程语言学***（如 Python 脚本测试、Shell 命令练***）
• 工具链熟悉（如 Git 命令实践、网络工具使用）

3.3 轻量级任务处理

• 临时数据处理（日志分析、文本转换）
• 远程服务器管理（通过容器内 SSH 客户端连接远程设备）

四、使用方法

4.1 基础运行命令（docker run）

通过以下命令启动交互式工作站容器，挂载本地目录并配置时区：

docker run -it \
  --name my-workstation \
  -v /path/to/local/workspace:/workspace \  # 挂载本地工作目录到容器内
  -e TIMEZONE=Asia/Shanghai \               # 设置时区为上海
  -e USER=dev \                             # 创建普通用户 dev（可选）
  --rm \                                    # 退出容器后自动清理（测试用）
  simple-workstation:latest

说明：-it 确保交互式终端支持；--rm 仅用于临时测试，生产环境建议移除以保留容器。

4.2 docker-compose 配置示例

创建 docker-compose.yml 实现持久化部署：

version: '3'
services:
  workstation:
    image: simple-workstation:latest
    container_name: my-workstation
    restart: unless-stopped  # 容器退出后自动重启（非手动停止时）
    environment:
      - TIMEZONE=Asia/Shanghai
      - USER=dev
      - PASSWORD=dev123  # 普通用户密码（若指定 USER 需配置）
    volumes:
      - ./workspace:/workspace  # 本地工作目录挂载
      - ./config/bashrc:/home/dev/.bashrc  # 挂载用户自定义 bash 配置
      - data-volume:/root/.ssh  # 数据卷存储 SSH 密钥（持久化）
    networks:
      - workstation-net  # 自定义网络（可选，用于容器间通信）

volumes:
  data-volume:  # 持久化数据卷（自动创建）

networks:
  workstation-net:
    driver: bridge

启动命令：docker-compose up -d

4.3 进入运行中的容器

若容器已后台运行，通过以下命令进入交互式终端：

docker exec -it my-workstation bash  # 或 zsh（若安装）

五、配置说明

5.1 环境变量

5.2 配置文件挂载

支持通过 -v 参数挂载用户自定义配置文件，覆盖容器默认配置：

• Bash 配置：-v /local/bashrc:/root/.bashrc（root 用户）或 /home/<USER>/.bashrc（普通用户）
• Vim 配置：-v /local/vimrc:/root/.vimrc
• Git 配置：-v /local/gitconfig:/root/.gitconfig

5.3 持久化数据管理

• 工作目录：推荐挂载本地目录到 /workspace，用于存放项目代码、文档等核心数据
• 配置数据：使用 Docker 数据卷（如示例中 data-volume）存储 SSH 密钥、工具配置等需长期保留的数据
• 备份建议：定期通过 docker cp 导出容器内重要配置文件，或直接备份挂载的本地目录

六、注意事项

1. 权限管理：挂载本地目录时，确保容器内用户（root 或自定义用户）对挂载目录有读写权限，避免因权限不足导致文件操作失败。

2. 网络配置：若需访问容器内服务（如临时启动的 HTTP 服务），需通过 -p 参数映射端口（如 -p 8080:8080）。

3. 安全性：生产环境中避免使用明文密码（PASSWORD 变量），建议通过 docker exec 进入容器后手动修改密码。

4. 镜像更新：定期拉取最新镜像（docker pull simple-workstation:latest）以获取工具版本更新和安全补丁。