nawaman/workspace

Coding Booth 工作空间镜像文档

镜像概述和主要用途

Coding Booth 是一个预配置的Docker镜像，旨在提供即开即用的集成编码工作空间。它整合了多种开发工具、编辑器和运行环境，消除了开发环境配置的复杂性，让开发者能够快速投入编码工作，无需担心环境差异问题。主要用途包括日常软件开发、编程学习、项目演示、教学环境搭建等场景，尤其适合需要快速部署一致开发环境的个人或团队。

核心功能和特性

• 集成化开发环境：内置VS Code Server、终端模拟器、文件管理器等核心工具，提供完整开发操作界面
• 多语言支持：预配置Python、JavaScript、Java、Go等主流编程语言的运行和构建环境
• 版本控制集成：包含Git、SVN等版本控制工具，支持代码提交、分支管理和冲突解决
• 即开即用：无需手动配置，拉取镜像后可直接启动完整工作空间，3分钟内即可开始编码
• 数据持久化：支持挂载本地目录，确保代码和配置数据在容器重启后不丢失
• 跨平台兼容：可在Windows、macOS、Linux及服务器环境中运行，兼容x86和ARM架构
• 资源优化：镜像体积控制在5GB以内，运行时内存占用低，适合各类硬件环境

使用场景和适用范围

适用用户

• 个人开发者：快速搭建个人开发环境，避免重复配置
• 学生和学习者：专注编程学习，无需担心环境设置问题
• 团队协作：统一团队开发环境，减少"在我电脑上能运行"问题
• 教育工作者：为学生提供一致的编程练习环境
• 开源贡献者：快速复现项目开发环境，参与开源项目

典型场景

• 日常软件开发和调试
• 编程课程教学与练习
• 临时项目开发或bug修复
• 技术研讨会现场演示
• 多语言环境快速切换测试

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10.0或更高版本）
• 已安装Docker Compose（可选，用于复杂配置）
• 网络连接（用于拉取镜像和更新组件）

基本使用步骤

1. 拉取镜像

bash
docker pull codingbooth/workspace:latest

2. 启动容器（基础配置）

bash
docker run -d \
  -p 8080:8080 \
  --name coding-booth \
  codingbooth/workspace:latest

3. 访问工作空间

容器启动后，在浏览器中访问 http://localhost:8080 即可打开Coding Booth工作空间界面（首次访问可能需要1-2分钟初始化）

高级配置示例

挂载本地目录（数据持久化）

bash
docker run -d \
  -p 8080:8080 \
  -v /本地代码目录:/workspace \
  -v /本地配置目录:/root/.config \
  --name coding-booth \
  codingbooth/workspace:latest

说明：/本地代码目录替换为实际本地文件夹路径，挂载后容器内/workspace目录与本地目录双向同步

设置访问密码和时区

bash
docker run -d \
  -p 8080:8080 \
  -v /本地代码目录:/workspace \
  -e PASSWORD=MySecurePass123 \
  -e TZ=Asia/Shanghai \
  --name coding-booth \
  codingbooth/workspace:latest

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  coding-booth:
    image: codingbooth/workspace:latest
    container_name: coding-booth
    restart: unless-stopped
    ports:
      - "8080:8080"  # Web访问端口
      - "2222:22"    # SSH访问端口（可选）
    volumes:
      - ./my-projects:/workspace       # 代码目录
      - ./ide-config:/root/.config     # 编辑器配置
      - ./extensions:/root/.vscode/extensions  # VS Code扩展
    environment:
      - PASSWORD=DevEnv2024!           # 访问密码
      - TZ=Asia/Shanghai               # 时区设置
      - EDITOR=code-server             # 默认编辑器
      - WORKSPACE_PORT=8080            # 工作空间端口
    mem_limit: 4g                      # 内存限制（可选）
    cpus: 2                            # CPU核心限制（可选）

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量配置

端口映射说明

注意事项

1. 首次启动：首次启动容器需要下载必要组件，可能需要3-5分钟，请耐心等待
2. 性能优化：若运行卡顿，可通过mem_limit和cpus参数调整资源分配
3. 安全建议：生产环境使用时务必设置强密码，并避免将8080端口直接暴露到公网
4. 数据备份：定期备份挂载的本地目录，防止数据意外丢失
5. 镜像更新：通过docker pull codingbooth/workspace:latest获取最新版本，更新前建议备份数据

常见问题解决

• 无法访问Web界面：检查容器是否正常运行（docker ps），端口是否被占用（netstat -tulpn）
• 中文显示乱码：设置环境变量LANG=zh_CN.UTF-8并重启容器
• 工具缺失：通过容器终端执行apt update && apt install -y 工具名安装所需工具
• 性能问题：减少同时运行的服务数量，或增加容器资源分配