Kasm Workspaces 无根 Docker 镜像文档

镜像概述和主要用途

Kasm Workspaces 是一个 Docker 容器流平台，用于通过浏览器提供对桌面、应用程序和 Web 服务的访问。本镜像包含可通过浏览器访问的 Docker 版本，以普通非 root 用户身份运行。该镜像设计用于 Kasm Workspaces 环境中，但也可独立部署并通过 Web 浏览器访问。

核心功能与特性

• 浏览器可访问：通过 Web 浏览器直接访问 Docker 环境，无需本地安装客户端
• 无根运行：Docker 以非 root 用户（kasm_user）运行，增强安全性
• Web 原生渲染：基于开源项目 KasmVNC 提供高性能、安全的 Web 渲染能力
• 环境变量支持：可通过环境变量自定义应用启动参数
• 灵活部署：支持在 Kasm Workspaces 中集成部署，也可独立运行
• 多标签策略：提供稳定版、滚动更新版和开发测试版标签，满足不同使用需求

使用场景和适用范围

• Kasm Workspaces 集成：作为 Kasm Workspaces 平台的一部分，提供容器化的 Docker 环境访问
• 独立浏览器访问：在没有 Kasm Workspaces 编排的情况下，通过浏览器快速部署和访问 Docker 环境
• 开发测试环境：为开发人员提供临时、隔离的 Docker 测试环境
• 教学演示：通过浏览器共享 Docker 操作过程，适合教学或演示场景

使用方法和配置说明

环境变量

独立部署

该镜像可独立部署，通过浏览器访问。执行以下命令启动容器：

bash
sudo docker run --rm -it --shm-size=512m -p 6901:6901 -e VNC_PW=password kasmweb/ubuntu-noble-dind-rootless:1.17.0

参数说明：

• --rm：容器退出后自动删除
• -it：交互式终端
• --shm-size=512m：设置共享内存大小为 512MB
• -p 6901:6901：将容器的 6901 端口映射到主机的 6901 端口（VNC 访问端口）
• -e VNC_PW=password：设置 VNC 访问密码为 "password"

访问方式：

容器启动后，通过浏览器访问：[***]

• 用户名：kasm_user
• 密码：password（即 VNC_PW 环境变量设置的值）

注意事项：

• 独立部署时，部分功能（如音频、上传、下载、麦克风 passthrough）不可用，这些功能仅在 Kasm Workspaces 编排环境中支持
• 更多配置说明请参考 Kasm 文档

标签说明

附加信息

源代码

• KasmVNC：开源 VNC 服务器，提供 Web 原生、安全、高性能的渲染能力
  GitHub 仓库
• Workspaces 镜像库：Kasm Workspaces 镜像集合
  GitHub 仓库
• 核心镜像库：基础操作系统镜像库，用于构建自定义镜像
  GitHub 仓库

文档资源

• Kasm Workspaces 安装指南：安装与配置说明
• 自定义镜像开发：自定义镜像配置与软件安装
• 开发者 API：与应用程序和工作流集成

问题反馈

• 社区问题追踪：GitHub Issue Tracker

截图

!镜像截图