kasmweb/core-fedora-40 镜像文档

1. 镜像概述和主要用途

kasmweb/core-fedora-40 是一个可通过浏览器访问的 Fedora 40 桌面环境 Docker 镜像。该镜像设计用于 Kasm Workspaces 容器流平台，提供基于 Web 的桌面、应用和服务访问能力。同时支持独立部署，允许用户通过浏览器直接访问 Fedora 40 环境。

2. 核心功能与特性

• Web 原生访问：通过浏览器即可访问完整的 Fedora 40 桌面环境，无需安装额外客户端
• VNC 协议支持：基于开源项目 KasmVNC 实现高性能、安全的 Web 渲染
• 灵活部署：支持在 Kasm Workspaces 中集成运行，或独立部署使用
• 增强功能集成：与 Kasm Workspaces 集成时，可支持音频传输、文件上传/下载、麦克风传递等高级功能

3. 使用场景和适用范围

• 独立远程环境：作为临时或轻量级 Fedora 40 桌面环境，通过浏览器远程访问
• Kasm Workspaces 节点：作为 Kasm Workspaces 平台的工作节点，提供标准化 Fedora 环境
• 开发测试：快速部署 Fedora 40 环境用于应用测试、兼容性验证或临时开发需求
• 演示环境：构建可通过浏览器共享的 Fedora 桌面演示环境

4. 使用方法和配置说明

4.1 独立部署

该镜像可独立运行，无需 Kasm Workspaces 编排。执行以下命令启动容器：

sudo docker run --rm -it --shm-size=512m -p 6901:6901 -e VNC_PW=password kasmweb/core-fedora-40:1.17.0

参数说明：

• --shm-size=512m：设置共享内存大小，优化桌面环境性能
• -p 6901:6901：映射容器 VNC 服务端口到主机（主机端口:容器端口）
• -e VNC_PW=password：设置 VNC 访问密码（必填）
• --rm：容器停止后自动清理
• -it：交互式终端支持

4.2 访问方式

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

登录凭据：

• 用户名：kasm_user
• 密码：启动命令中设置的 VNC_PW 值（示例中为 password）

4.3 功能限制说明

独立部署时，部分功能将受限：
✅ 基础桌面环境访问
❌ 音频传输
❌ 文件上传/下载
❌ 麦克风传递

上述受限功能仅在 Kasm Workspaces 中集成运行时可用。

5. 标签说明

6. 附加信息

6.1 源代码与项目

• KasmVNC：Web 原生 VNC 服务器，提供高性能渲染
  GitHub 仓库

• Workspaces 镜像库：Kasm Workspaces 官方镜像集合
  GitHub 仓库

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

6.2 文档资源

• Kasm Workspaces 安装指南：
  官方文档

• 自定义镜像开发：配置自定义镜像和软件安装指南
  文档链接

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

6.3 问题反馈

如遇镜像相关问题，可通过 GitHub Issue Tracker 提交：
问题跟踪

6.4 截图预览

!Fedora 40 桌面环境截图

注意：独立部署模式下部分功能受限，完整功能需配合 Kasm Workspaces 使用。更多信息请参考 Kasm Workspaces 官方文档。