用途:在 Linux 服务器上安装、配置、管理和排查 KASM Workspaces——一个基于容器的 VDI 平台,把桌面串流到浏览器。技能按任务分流,先询问用户需求,再读取对应参考文件:全新安装、工作区配置(profiles、卷、Docker 覆盖)、故障排查、备份与恢复、Cloudflare Tunnel 或反向代理、数据库查询与维护、API 调用与自动化、服务管理(启停/日志)。
主要能力与关键信息:系统要求 Docker >= 25.0.5、Docker Compose >= 2.40.2,最低 2 核、4GB 内存、75GB SSD,每会话默认 2,768MB 内存加 2 核,强烈建议配置 swap;支持 Ubuntu 22.04/24.04、Debian 11/12、RHEL 8/9/10、Oracle Linux 8/9、AlmaLinux/Rocky 8/9、Raspberry Pi OS 11/12,架构 amd64 与 arm64。关键路径包括 /opt/kasm/current/(安装根目录)、/opt/kasm/current/log/(日志)、/mnt/kasm_profiles/(持久化配置卷挂载)、/var/lib/docker。关键容器有 kasm_api、kasm_agent、kasm_manager、kasm_proxy、kasm_db(PostgreSQL,用户 kasmapp,库 kasm)。
使用方式:服务控制命令为 sudo /opt/kasm/current/bin/stop、sudo /opt/kasm/current/bin/start、sudo docker restart kasm_api、sudo docker logs -f kasm_api。
限制与规则:必须在安装 KASM 前先装 Docker CE 与 Compose 插件;务必配置 swap,否则即使内存充足也可能不稳定;每个并发会话约需 2-4GB 内存,需据此规划服务器;不要在无 HTTPS 情况下公开 8443 端口;KASM API 使用 JSON 载荷认证而非 HTTP Basic Auth,且 API 把工作区称为 images(get_images 而非 get_workspaces);S3 持久化配置路径必须包含 @endpoint,否则会产生过多 API 调用。切勿在技能文件夹内存放真实 .env 或凭据,.env.template 仅放 assets/,真实密钥存于 ~/.admin/.env。相关技能:devops、backblaze-b2、各云厂商技能、cloudflare-worker-base。官方文档见 https://kasmweb.com/docs/latest/ 与 https://docs.kasm.com/。