SuperAPI AI 工具集

portainer

通用与其它

查看项目

更新于 10-16 01:49

技能介绍

Portainer Skill 用于通过 Portainer 的 REST API 管理 Docker 基础设施,无需打开 Web UI 即可操作容器、堆栈与部署。

主要能力:查看 Portainer 服务器状态;列出 Docker 环境(endpoints);列出、启动、停止、重启容器;列出并管理 Docker Compose 堆栈;从 Git 拉取并重新部署堆栈;查看容器日志。

使用前提:Portainer 2.x 且开放 API 访问,工具需 curl 和 jq,认证需 API Access Token。令牌获取方式:登录 Portainer Web UI,点用户名进入 My Account,在 Access tokens 中新增并复制令牌。

配置方式:在 ~/.clawdbot/.env 中设置 PORTAINER_URL=https://your-portainer-server:9443 PORTAINER_API_KEY=ptr_your_token_here

常用命令: ./portainer.sh status ./portainer.sh endpoints ./portainer.sh containers ./portainer.sh containers 3 ./portainer.sh stacks ./portainer.sh stack-info 25 ./portainer.sh redeploy 25 ./portainer.sh start steinbergerraum-web-1 ./portainer.sh stop steinbergerraum-web-1 ./portainer.sh restart steinbergerraum-web-1 4 ./portainer.sh logs steinbergerraum-web-1 4 50

适用场景:合并 PR 后重新部署站点并查看日志;排查容器问题时查看日志并重启;快速获取状态、环境、容器与堆栈总览;通过对话式的 Clawd 集成触发部署与重启。

限制与排错:redeploy 若遇 git 认证错误,脚本会自动从现有堆栈配置读取 repositoryGitCredentialID;容器名需与 containers 输出完全一致且区分大小写;若提示 PORTAINER_URL 和 PORTAINER_API_KEY 必须设置,需先将凭据写入 ~/.clawdbot/.env。默认使用 endpoint 4,可在命令中指定。

版本 1.0.0(2026-01-25 初始发布)。作者 Andy Steinberger。其他信息暂未提供。