KasmOS Desktop Docker镜像文档

1. 镜像概述和主要用途

KasmOS Desktop是Kasm Workspaces容器流平台的一部分，提供基于浏览器访问的桌面环境。本镜像包含预装多种生产力和开发应用的KasmOS桌面，旨在为通用生产力场景提供熟悉的用户界面（UI），支持通过Web浏览器远程访问桌面环境。

2. 核心功能和特性

• 浏览器原生访问：无需安装客户端，通过Web浏览器直接访问桌面环境
• 预装应用生态：集成多种生产力工具和开发软件，满足日常工作需求
• KasmVNC技术：基于开源KasmVNC项目，提供Web原生、安全且高性能的远程桌面渲染
• 灵活部署模式：支持独立运行，也可集成到Kasm Workspaces平台实现完整功能
• 多版本标签：提供稳定版、滚动更新版和开发测试版标签，适配不同使用场景

3. 使用场景和适用范围

• 通用生产力场景：需通过浏览器访问桌面环境进行文档处理、网页浏览等日常任务
• 开发与测试环境：快速启动预配置的开发桌面，适合临时测试或演示
• 远程办公需求：无需复杂客户端配置，通过浏览器即可远程使用完整桌面环境
• Kasm Workspaces集成：作为Kasm Workspaces平台的桌面节点，实现音频、文件传输等高级功能
• 社区版适用：适合个人用户或小型团队使用Kasm Workspaces社区版构建远程桌面服务

4. 使用方法和配置说明

4.1 独立部署

本镜像可独立运行，无需Kasm Workspaces平台，直接通过浏览器访问。

4.1.1 基础部署命令

bash
sudo docker run --rm -it --shm-size=512m -p 6901:6901 -e VNC_PW=password kasmweb/kasmos-desktop:1.17.0

4.1.2 参数说明

4.1.3 访问方式

容器启动后，通过浏览器访问：
https://<服务器IP地址>:6901

登录凭据：

• 用户名：kasm_user
• 密码：通过VNC_PW环境变量设置（示例中为password）

4.1.4 功能限制说明

独立部署时，部分功能受限于Kasm Workspaces平台依赖，无法使用，包括：

• 音频输入/输出
• 文件上传/下载
• 麦克风passthrough
• 高级权限管理

5. 镜像标签说明

6. 附加信息

6.1 源代码与核心组件

• KasmVNC：开源VNC服务器，提供Web原生、安全、高性能的远程桌面渲染
  GitHub仓库

• Workspaces镜像库：Kasm Workspaces***Docker镜像集合（含本镜像源码）
  GitHub仓库

• 核心基础镜像：用于构建自定义镜像的OS基线库
  GitHub仓库

6.2 ***文档资源

• Kasm Workspaces安装指南：部署完整平台的配置说明
  安装文档

• 自定义镜像开发：构建包含自定义软件的桌面镜像教程
  开发文档

• 开发者API：与外部应用和工作流集成的接口文档
  API文档

6.3 问题反馈

社区问题跟踪：通过GitHub Issues提交bug报告或功能建议
Issue Tracker

7. 镜像截图

!KasmOS Desktop截图
KasmOS Desktop桌面环境预览（含预装应用快捷方式）