容器巡检工具

技能简介

docker-ctl 是一个基于 Podman 的容器管理辅助工具，用于快速查看运行中的容器状态、读取实时日志以及检查本地镜像信息。该工具专为 Bazzite/Fedora 系统设计，无需额外配置即可直接使用。

业务背景

运维人员日常排查容器故障时，常需快速定位问题根源。该工具基于Podman环境，无需复杂配置即可实时查看容器运行状态、日志输出及镜像信息，帮助团队缩短故障排查时间，降低对专业命令行的依赖门槛，提升Bazzite/Fedora系统下的容器运维效率。

落地案例：某开发团队在Bazzite系统上部署微服务后，发现某个服务响应异常。运维人员使用docker-ctl ps快速确认容器仍在运行，随即通过docker-ctl logs调取该容器的实时日志，发现数据库连接超时错误；再执行docker-ctl inspect查看网络配置，定位到端口映射冲突。全程无需登录宿主机执行复杂命令，10分钟内完成问题诊断。

能做什么

• 列出当前运行的容器及其基本信息
• 查看指定容器的实时或历史日志输出
• 浏览本地存储的容器镜像列表
• 获取容器的详细配置与元数据

使用说明

该工具依赖 Podman 运行时环境，在 Bazzite 系统中已预装，无需手动安装。

1. 确认系统环境：确保当前为 Bazzite 或已安装 Podman 的 Fedora 系统
2. 直接使用命令：docker-ctl [command]
3. 常用指令示例：
   docker-ctl ps — 列出运行中容器
   docker-ctl logs <container> — 查看容器日志
   docker-ctl images — 列出本地镜像
   docker-ctl inspect <container> — 检查容器详情

输入与输出

见下方输入与输出表格。

风险提示

• 查看日志时可能暴露敏感信息，注意操作环境安全
• inspect 命令输出的配置信息包含系统路径和网络设置，谨慎分享
• 该工具仅支持读取操作，无法直接修改容器状态

来源信息

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