用途:通过 Portainer 的 REST API 管理 Docker 基础设施,无需操作 Web 界面即可管理容器、堆栈与部署。
主要能力:查看 Portainer 服务器状态;列出所有 Docker 环境(endpoints);列出、启动、停止、重启容器;列出并可管理 Docker Compose 堆栈;从 git 拉取并重新部署堆栈(重建容器、重启堆栈);查看容器日志。
使用方式:需已安装 Portainer 2.x 并开放 API,本地工具需 curl 与 jq,并配置 API 访问令牌。在 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 检查服务器;endpoints 列出环境;containers [endpoint] 列出容器;stacks 列出堆栈;stack-info <id> 查看堆栈详情;redeploy <id> 从 git 拉取并重新部署;start/stop/restart <容器名> [endpoint] 控制容器;logs <容器名> [endpoint] [行数] 查看日志(默认 100 行,默认 endpoint 为 4)。
限制与注意:需有效的 API 令牌,否则报认证错误;容器名须与列表中完全一致且区分大小写;堆栈重新部署需仓库凭据,脚本会从现有堆栈配置自动读取;端口与服务器地址、具体可用版本等未在资料中提供。