k8sgpt-ai/k8sgpt

这是什么？

核心功能

• 01通过内置分析器扫描 Pod、Service、Deployment、Ingress、PVC 等 Kubernetes 资源。
• 02使用所选大模型后端，用通俗英文解释检测到的问题。
• 03支持 OpenAI、Azure、Bedrock、Gemini、Ollama、LiteLLM 等多种后端。
• 04发送数据给 AI 后端前可对对象名称进行匿名化。
• 05可按资源类型和命名空间过滤结果，并支持 JSON 输出。
• 06提供 serve 模式和 MCP 服务，便于与 AI 助手集成。

适用场景

• 在不逐条翻阅大量 kubectl 输出的情况下，快速定位集群中出故障的工作负载。
• 定期扫描集群，并将 JSON 结果交给其他工具处理。
• 通过 MCP 让 Claude Desktop 等 AI 助手获取集群健康信息。
• 集群数据不能外发时，使用本地模型进行分析。

快速上手

1. 1

   使用 Homebrew 安装 k8sgpt

   brew install k8sgpt
2. 2

   生成 OpenAI API 密钥(会打开浏览器链接)

   k8sgpt generate
3. 3

   将 API 密钥添加到 k8sgpt

   k8sgpt auth add
4. 4

   扫描集群并解释问题

   k8sgpt analyze --explain

使用前须知

• !默认的 AI 后端是 OpenAI,除非配置其他提供商,否则需要 OpenAI API 密钥。
• !分析需要可访问的 Kubernetes 集群,并且解释功能需要已配置的 AI 后端。

收录于专题

标签

常见问题

k8sgpt 是什么？

一款扫描 Kubernetes 集群问题并借助大模型用通俗英文解释诊断结果的命令行工具。 k8sgpt 会扫描 Kubernetes 集群，运行内置的分析器（这些分析器封装了常见的 SRE 检查经验），并报告发现的问题。覆盖 Pod、Service、Deployment、Ingress、PVC、Node 和 Webhook 等资源，也可开启 HPA、NetworkPolicy、Gateway API 以及 OLM 相关对象的检查。

k8sgpt 可以免费使用吗？用的什么许可证？

k8sgpt 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

k8sgpt 还在维护吗？

活跃维护中。k8sgpt 最近一次提交是在 2026年10月24日。

k8sgpt 适合用来做什么？

在不逐条翻阅大量 kubectl 输出的情况下，快速定位集群中出故障的工作负载。 定期扫描集群，并将 JSON 结果交给其他工具处理。 通过 MCP 让 Claude Desktop 等 AI 助手获取集群健康信息。 集群数据不能外发时，使用本地模型进行分析。

k8sgpt 怎么安装和运行？

使用 Homebrew 安装 k8sgpt: brew install k8sgpt 生成 OpenAI API 密钥(会打开浏览器链接): k8sgpt generate 将 API 密钥添加到 k8sgpt: k8sgpt auth add 扫描集群并解释问题: k8sgpt analyze --explain

在哪里获取 k8sgpt？

源代码和安装说明在 GitHub 上：https://github.com/k8sgpt-ai/k8sgpt