alnoda/workspace-in-docker

通用Docker工作空间

镜像概述和主要用途

这是一个Docker化的通用工作空间，是完全隔离在Docker容器内的开发环境。它可以在任何地方运行，支持启动/停止、迁移到其他机器、归档为文件或恢复、推送到Docker仓库、在云服务器上启动。工作空间包含浏览器版的Visual Studio Code（Eclipse Theia）及多种浏览器工具，方便在容器内进行开发工作。

!https://raw.githubusercontent.com/bluxmit/alnoda-workspaces/main/workspaces/workspace-in-docker/img/wid-collage.png

核心功能和特性

带UI的工具

• 工作空间自有UI：从一个地方启动所有工作空间工具，可根据需求自定义，包含文档。
• Eclipse Theia：开源版Visual Studio Code IDE，支持VS Code扩展，运行在浏览器中，已安装多种主题和常用插件。
• Terminal：安全的浏览器终端。
• FileBrowser：管理工作空间内的文件和文件夹，实现本地环境与工作空间间的数据交换。
• Cronicle：任务调度和运行器，带有基于Web的前端UI，支持计划任务、重复任务和按需任务。
• Static File Server：轻松查看静态HTML网站，方便部署静态网站。
• Ungit：提供友好的Git用户界面，不牺牲Git的多功能性。
• MkDocs：仅使用Markdown维护工作空间或项目文档。
• Midnight Commander：功能丰富的可视化文件管理器，带有内部文本查看器和编辑器。
• Process Monitor：监控运行进程和资源利用率。

其他功能

• Docker in docker
• Zsh、Oh my Zsh
• Python 3、Pip
• Node/nodeenv
• git、git-flow
• curl、wget、telnet、jq
• nano、vim、mc、ncdu、htop
• supervisord
• cron

注意：这是codeserver-workspace的替代工作空间，具备后者的所有功能，仅Visual Studio Code的实现不同。

使用场景和适用范围

工作空间是完全自包含且隔离的开发环境，适用于以下场景：

• 避免在笔记本电脑上繁琐的开发环境设置
• 在同一台机器上方便地处理多个IT项目
• 能够将所有工作迁移到另一台机器
• 简单快速地开始编码
• 在云端运行开发环境，从任何设备工作，独立于云提供商
• 备份包含重要工作的整个工作空间，在更改前保存工作空间版本
• 通过共享整个工作空间或在云端运行与同事协作
• 几分钟内从开发过渡到POC
• 进行实验（尝试新包、版本、框架）而不影响现有环境
• 用单个命令启动、停止和恢复与同一项目相关的作业计划
• 为团队创建自定义开发环境，帮助新成员节省环境设置时间
• 在功能强大的Windows PC和macOS笔记本电脑之间来回移动开发环境

详细使用方法和配置说明

快速试用

sh
docker run --name space-1 -d -p 8020-8035:8020-8035 alnoda/workspace-in-docker

启动工作空间

工作空间本质上是Docker容器，管理工作空间只需使用Docker命令。

基本启动命令

sh
docker run --name space-1 -d -p 8020-8035:8020-8035 alnoda/workspace-in-docker

建议以守护进程模式运行工作空间

启动后，打开 http://localhost:8020 访问工作空间UI，从这里可以打开所有工作空间工具。

工作区终端

有多种方式使用工作空间终端：

• 内置浏览器终端
• 浏览器IDE提供的终端 http://localhost:8025（除非映射了其他端口）
• 从本地终端SSH进入运行的工作空间容器

!https://raw.githubusercontent.com/bluxmit/alnoda-workspaces/main/workspaces/base-workspace/img/base-workspace-terminal.gif

浏览器终端始终以启动工作空间的用户身份运行，默认是非root用户"abc"

从本地终端进入运行的工作空间容器：

sh
docker exec -it space-1 /bin/zsh

若不使用z-shell：

sh
docker exec -it space-1 /bin/bash

以root用户身份进入：

sh
docker exec -it --user=root space-1 /bin/zsh

在工作空间内执行以下命令查看当前用户：

whoami

多工作空间

每个工作空间需要一系列端口。若一个工作空间正在运行，端口8020-8035将被占用。工作空间本身使用9个端口（8020-8028），建议映射额外端口以备将来使用。

要同时运行多个工作空间，需使用不同的端口范围，例如：

sh
docker run --name space-2 -d -p 8040-8055:8020-8035 -e ENTRY_PORT=8040 alnoda/workspace-in-docker

需设置环境变量ENTRY_PORT，其值应等于新端口范围的第一个端口，工作空间UI使用此变量重定向到正确的应用地址。

端口理解

工作空间启动时映射了端口范围-p 8020-8035，因为包含多个带浏览器UI的应用：

无需记住这些端口，通过工作空间UI（localhost:8020）可打开所有应用。

!https://raw.githubusercontent.com/bluxmit/alnoda-workspaces/main/workspaces/workspace-in-docker/img/wid-ui.png

端口范围内的其余端口可用于公开可选应用或将来安装的应用。若需公开更多应用，可添加额外端口映射：

sh
docker run --name space-1 -d -p 8020-8035:8020-8035 -p 8080:8080 alnoda/workspace-in-docker

可添加多个端口映射：

sh
docker run --name space-1 -d -p 8020-8035:8020-8035 -p 8080:8080 -p 443:443 alnoda/workspace-in-docker

Docker in docker

可直接从工作空间（使用工作空间终端）使用Docker：

sh
docker run --name space-1 -d -p 8020-8035:8020-8035 -v /var/run/docker.sock:/var/run/docker.sock alnoda/workspace-in-docker

要使用docker in docker，需以root用户身份进入工作空间容器：

sh
docker exec -it --user=root space-1 /bin/zsh

在远程服务器上运行

非安全远程工作空间

在远程服务器上运行工作空间只需3步：

1. 在云服务提供商（Digital Ocean、Linode、AWS等）获取虚拟服务器
2. 在服务器上安装Docker
3. SSH到远程服务器并启动工作空间：

sh
docker run --name space-1 -d -p 8020-8035:8020-8035 -e WRK_HOST="<远程服务器IP>" alnoda/workspace-in-docker

运行远程工作空间时，需添加环境变量-e WRK_HOST="<远程服务器IP>"，工作空间UI需要此变量正确重定向应用地址。

在浏览器中打开 <远程服务器IP>:8020 访问工作空间。

若需要docker in docker：

sh
docker run --name space-1 -d -p 8020-8035:8020-8035 -e WRK_HOST="<远程服务器IP>" -v /var/run/docker.sock:/var/run/docker.sock alnoda/workspace-in-docker

安全远程工作空间

工作空间包含工具，可生成在云端安全运行工作空间所需的一切（带身份验证和TLS）。

在本地启动工作空间，打开终端，使用工具/home/abc/utils/remote.py生成带TLS证书的docker-compose项目：

python /home/abc/utils/remote.py --workspace="workspace-in-docker" --port="8020" --host="68.183.69.198" --user="user1" --password="pass1"

需指定正确的主机（要运行工作空间的服务器IP）以及自定义的用户名和密码。

命令执行后，会创建文件夹/home/abc/utils/remote，使用Filebrowser将其下载到本地环境，然后复制到远程服务器。SSH到服务器，进入该目录并执行：

sh
docker-compose up -d

工作空间将在远程服务器上安全运行，使用自签名TLS证书进行加密HTTPS通信，并添加身份验证。

浏览器会显示自签名证书警告，接受风险后，将出现身份验证窗口，输入设置的用户名和密码。

进一步链接

• https://github.com/bluxmit/alnoda-workspaces/blob/main/workspaces/workspace-in-docker/README.md#use-workspace
• https://github.com/bluxmit/alnoda-workspaces/blob/main/README.md