kasm-admin

KASM 管理 — 运维管理

用途：管理正在运行的 KASM 服务器 — 工作区、用户、会话、资源和机器人 Agent。

前提条件：KASM 已安装并配置。如需安装，请使用 /kasm。

步骤 0：确定管理需求

任务	参考文档
工作区 CRUD（创建、克隆、更新、删除）	references/workspace-management.md
会话监控与管理	references/session-management.md
用户和群组管理	references/user-group-management.md
批量操作（跨工作区更新配置）	references/bulk-operations.md
资源监控与容量规划	references/capacity-planning.md
多 Agent 机器人部署模式	references/multi-agent-patterns.md
备份、还原及 S3/B2 配置文件同步	references/backup-operations.md
常见 Docker 配置（可直接复制粘贴）	references/config-templates.md

API 身份验证

所有 KASM API 调用都使用 JSON 载荷进行身份验证（而非 HTTP Basic Auth）：

curl -k -X POST "https://$KASM_HOST/api/admin/$ENDPOINT"   -H "Content-Type: application/json"   -d '{
    "api_key": "$KASM_API_KEY",
    "api_key_secret": "$KASM_API_SECRET"
  }'

API 凭据存储在管理员保管库中（KASM_API_KEY、KASM_API_SECRET）。

关键术语

UI 术语	API 术语	数据库表
工作区	镜像	images
会话	Kasms	kasms
存储映射	存储提供程序	storage_providers
API 密钥	API 配置	api_configs

快速参考 — 最常见的操作

检查服务器运行状况

# Via sentinelctl (recommended)
sentinelctl pull --config fleet.json --token $TOKEN --connection-mode direct

# Via KASM API
curl -k -X POST "https://$KASM_HOST/api/admin/system_info"   -H "Content-Type: application/json"   -d '{"api_key":"$KEY","api_key_secret":"$SECRET"}'

列出所有工作区

curl -k -X POST "https://$KASM_HOST/api/public/get_images"   -H "Content-Type: application/json"   -d '{"api_key":"$KEY","api_key_secret":"$SECRET"}'

列出活动会话

curl -k -X POST "https://$KASM_HOST/api/admin/get_kasms"   -H "Content-Type: application/json"   -d '{"api_key":"$KEY","api_key_secret":"$SECRET"}'

快速数据库查询

# List workspaces with resources
sudo docker exec kasm_db psql -U kasmapp -d kasm -c   "SELECT image_id, friendly_name, cores, memory, enabled FROM images ORDER BY friendly_name;"

# Active sessions with resource usage
sudo docker exec kasm_db psql -U kasmapp -d kasm -c   "SELECT k.kasm_id, i.friendly_name, u.username, k.start_date FROM kasms k JOIN images i ON k.image_id = i.image_id JOIN users u ON k.user_id = u.user_id WHERE k.operational_status = 'running';"

# Users and groups
sudo docker exec kasm_db psql -U kasmapp -d kasm -c   "SELECT u.user_id, u.username, string_agg(g.name, ', ') as groups FROM users u LEFT JOIN group_membership gm ON u.user_id = gm.user_id LEFT JOIN groups g ON gm.group_id = g.group_id GROUP BY u.user_id, u.username ORDER BY u.username;"