kasmweb/debian-bookworm-desktop

Kasm Workspaces Debian Bookworm桌面镜像文档

镜像概述和主要用途

Kasm Workspaces是一个Docker容器流传输平台，用于通过浏览器提供对桌面、应用程序和Web服务的访问。本镜像包含可通过浏览器访问的Debian Bookworm桌面环境，预装多种生产力和开发应用，设计用于Kasm Workspaces原生运行，也可独立部署。

核心功能和特性

• 浏览器访问：通过Web浏览器直接访问Debian Bookworm桌面环境，无需额外客户端
• 预装应用：包含Signal等生产力工具及开发应用
• 安全渲染：基于开源KasmVNC技术，提供Web原生、安全、高性能的VNC服务
• 灵活部署：支持Kasm Workspaces环境集成或独立部署
• Signal配置：预装Signal应用，需注意SSL拦截规避配置（详见下文）

使用场景和适用范围

• Kasm Workspaces集成：作为Kasm Workspaces平台的桌面环境节点，提供受控的远程桌面服务
• 独立远程桌面：通过浏览器快速部署和访问独立的Debian桌面环境
• 开发/测试环境：临时开发环境或应用测试沙箱
• 生产力工具访问：需要通过浏览器远程使用桌面应用的场景

详细使用方法和配置说明

Signal应用网络配置

Signal应用实施严格安全规则，若检测到SSL拦截（MitM）会阻止网络访问。当启用WebFilter时，需将以下域名添加至WebFilter配置的SSL绕过域名列表（注意前缀点(.)确保所有子域名均被绕过）：

.signal.org
.signal.art
.signal.tube
.signal.group
.signal.link
.signal.me

独立部署

本镜像虽设计用于Kasm Workspaces，但可独立部署并通过浏览器访问：

部署命令

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

参数说明

• --shm-size=512m：设置共享内存大小，确保桌面环境流畅运行
• -p 6901:6901：映射容器VNC服务端口到主机
• -e VNC_PW=password：设置VNC访问密码
• --rm：容器退出后自动删除
• -it：交互式终端模式

访问方式

通过浏览器访问：https://服务器IP:6901

• 用户名：kasm_user
• 密码：password（与VNC_PW环境变量值一致）

功能限制说明

独立部署时，部分功能（如音频、上传、下载、麦克风穿透）仅在使用Kasm Workspaces编排时可用。

标签说明

• 1.17.0：基于Kasm Workspaces发布版本构建和标记的镜像
• 1.17.0-rolling：滚动更新标签，每晚自动构建更新，确保镜像为最新版本
• develop：测试标签，用于开发环境，不保证兼容性

附加信息

源代码

• KasmVNC GitHub：开源VNC服务器，提供Web原生、安全、高性能的远程桌面服务 (https://github.com/kasmtech/KasmVNC)
• Workspaces Images GitHub：Workspaces Docker镜像库 (https://github.com/kasmtech/workspaces-images)
• Core Images GitHub：自定义镜像的核心OS基线库 (https://github.com/kasmtech/workspaces-core-images)

Workspaces文档

• 开发者API：与应用和工作流集成的接口文档 (developer_api)
• Workspaces安装：Kasm Workspaces安装和配置指南 (installation)
• 自定义镜像：自定义镜像配置和软件安装说明 (custom_images)

问题反馈

• GitHub Issue Tracker：社区问题反馈平台 (https://github.com/kasmtech/workspaces-issues/issues)