Portainer容器管理

技能简介

通过Portainer REST API远程管理Docker容器与堆栈，无需登录Web界面即可完成日常运维操作。

业务背景

运维团队无需登录Portainer Web界面，即可远程完成Docker容器与堆栈的日常管理。通过API直接查看服务器状态、启停容器、追踪日志，减少操作步骤；支持Git拉取重新部署Compose堆栈，让开发迭代和故障排查更高效，降低多环境切换的时间成本。

落地案例：某电商大促前，运维人员需批量重启多个微服务容器并确认状态。使用本工具执行./portainer.sh logs 订单服务-container-01 实时抓取异常日志，发现内存告警后，立即调用重启指令完成热修复，全程无需打开浏览器登录Portainer，5分钟内恢复服务可用性。

能做什么

• 查看Portainer服务器状态与端点列表
• 列出、启动、停止、重启容器
• 管理Docker Compose堆栈，支持Git拉取重新部署
• 实时查看容器日志输出

使用说明

安装依赖：系统需预装curl和jq。

配置步骤：

1. 登录Portainer Web界面，进入「用户设置 → 访问令牌」生成API密钥
2. 在~/.clawdbot/.env文件中添加：
   PORTAINER_URL=https://your-server:9443
PORTAINER_API_KEY=ptr_your_token
3. 运行./portainer.sh status验证连接

常用命令：

• ./portainer.sh containers — 列出所有容器
• ./portainer.sh start|stop|restart 容器名 — 控制容器状态
• ./portainer.sh redeploy 堆栈ID — 从Git更新并重新部署
• ./portainer.sh logs 容器名 [端点ID] [行数] — 查看日志

输入与输出

见下方输入与输出表格。

风险提示

• API密钥具备完整管理权限，请妥善保管环境变量文件
• 重新部署操作会中断服务，生产环境建议先确认堆栈配置
• 容器名称区分大小写，需使用完整名称匹配
• 直接操作运行中容器可能导致数据丢失或服务中断

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/asteinberger/portainer/SKILL.md
来源类型：开源社区技能

常见问题

Q1：Portainer容器管理 适合哪些场景？
A：适合需要「通过Portainer REST API远程管理Docker容器与堆栈，」的场景，尤其是希望快速验证并落地的团队与个人。

Q2：第一次使用应该先做什么？
A：先明确目标任务，再按照页面中的“能做什么”和“使用说明”完成最小可行流程。

Q3：如何判断是否值得长期使用？
A：建议连续使用 1-2 周，对比效率、稳定性和协作成本，再决定是否纳入长期工具栈。

替代方案

• 版本发布管理
• 智能自动更新器
• Pulse应用生成

相关推荐

• Perry隔离工作区
• Docker基础
• Bot状态API服务
• 机器人状态API