Arcane容器管理

技能简介

Arcane Docker Manager 提供完整的 Docker 资源管理能力，通过 REST API 对接容器、Compose 栈、模板、网络、卷、镜像及系统监控模块。

能做什么

• 容器的启停、重启、删除、日志查看与资源更新
• Docker Compose 栈的部署、更新、下线与环境变量注入
• 模板化快速部署与自定义 Compose 文件部署
• 镜像拉取、清理与批量管理
• 网络与卷的创建与绑定
• 实时系统资源与容器统计监控
• 用户账户与 API 密钥的生命周期管理

使用说明

安装与配置

1. 确保 Arcane 服务已运行，默认地址 http://localhost:3552/api
2. 获取认证令牌：

   curl -X POST "$BASE_URL/auth/login" \
     -H "Content-Type: application/json" \
     -d '{"username":"admin","password":"your_password"}'

3. 或使用长期 API Key：在请求头中加入 X-API-Key: your-api-key

基础调用示例

# 列出所有容器
curl -X GET "$BASE_URL/containers" -H "Authorization: Bearer $TOKEN"

# 启动指定容器
curl -X POST "$BASE_URL/containers/{id}/start" -H "Authorization: Bearer $TOKEN"

# 部署 Compose 栈
curl -X POST "$BASE_URL/stacks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"web-stack","composeContent":"version:\"3.8\"\nservices:\n  web:\n    image:nginx:latest"}'

输入与输出

见下方输入与输出表格。

风险提示

• 容器删除操作不可逆，执行前确认数据已备份
• Compose 栈更新可能导致服务中断，建议在低峰期操作
• API 密钥泄露将带来未授权访问风险，需定期轮换
• 直接执行容器内命令可能影响运行中服务稳定性

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/cougz/arcane-docker-manager/SKILL.md
来源类型：GitHub 仓库