kubewall

一个二进制搞定多集群 K8s 管理，还能用 AI 帮你排障

kubewall 是一个用 Go 和 TypeScript 构建的单二进制 Kubernetes 仪表盘，专注于多集群管理和 AI 集成。它解决了传统 Kubernetes 仪表盘在集群切换、资源查看和操作上的繁琐问题，提供统一的 Web 界面来管理多个集群。核心能力包括：多集群集中管理、资源可视化（Deployment、Pod、Service 等）、日志查看、端口转发、以及内置 AI 助手（支持 OpenAI、Claude、Gemini、DeepSeek 等主流模型），可辅助排查故障、生成 YAML 配置。项目以单文件分发，部署简单，适合开发者和运维人员快速上手。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1937

维护状态活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队kubewall

所属国家

官网地址

GitHubhttps://github.com/kubewall/kubewall

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自行部署，完全免费。

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型cloud-native,dashboard,developer-tools,devops,golang,k8s,k8s-dashboard,kubectl,kubernetes,kubernetes-dashboard,kubernetes-debugging,kubernetes-helper,kubernetes-monitoring,kubernetes-troubleshooting,kubernetes-ui,lmstudio,ollama,orchestration,productivity

GitHub 星标★ 1937

30天Star增速

HF 下载量

上线时间2024-09-10 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：Docker 3 步

环境要求

已安装 Docker 并能访问 ghcr.io 镜像仓库
宿主机存在 ~/.kube 目录（kubeconfig 配置文件）
Linux 环境（--network host 仅在 Linux 上生效）
磁盘可写入容器卷 kubewall 用于持久化数据

安装与启动步骤

1确认 kubeconfig

kubewall 通过挂载的 kubeconfig 读取集群信息，请先确认 ~/.kube 目录已存在并包含可用的 config 文件。
```
ls ~/.kube
```
2拉取并启动容器

按 README 的 Docker 命令启动，挂载 kubeconfig 与数据卷，并使用 host 网络模式直接对外提供服务。
```
docker run --network host -v kubewall:/.kubewall -v ~/.kube:/.kube ghcr.io/kubewall/kubewall:latest
```
3自定义监听地址

如需更换 IP 或端口，使用 --listen 参数。:7080 表示绑定所有网卡的 7080 端口；也可写具体网卡地址。
```
kubewall --listen :7080
```

关键配置

配置项	必填	说明	示例
`--listen`	否	指定 kubewall 绑定的 IP 与端口，不写则使用默认值（README 未给出默认端口）	`:7080`

如何确认成功

用 docker ps 确认容器处于运行状态，再在浏览器打开 --listen 指定的地址端口（如 http://localhost:7080）看到 kubewall 界面。

常见问题

Q：默认监听端口是多少？

A：README 未明确写出默认端口，建议启动时用 --listen 显式指定，例如 :7080 或 192.168.1.10:8080，避免猜测。

Q：AI 助手支持哪些模型？

A：README 列出支持 OpenAI、Claude、Gemini、DeepSeek、OpenRouter、Ollama、Qwen、LMStudio 等，需在界面中配置对应模型与密钥。

Q：能同时管理多个集群吗？

A：可以，kubewall 的核心能力就是多集群集中管理，可在同一界面切换和查看不同集群资源。

Q：Windows 或 Mac 能用吗？

A：README 说明以单二进制形式支持 Mac、Windows、Linux，但节选未给出二进制安装命令，请参考官方 Releases 页面下载。

注意事项

README 节选只提供了 Docker 安装方式，二进制安装步骤请以官方 Releases 说明为准。
Docker 命令中的 -v kubewall:/.kubewall 为命名卷挂载，用于持久化 kubewall 自身数据，请勿随意删除。
--network host 在 Docker Desktop（Mac/Windows）上行为受限，如需固定端口可改用 --listen 配合端口映射。
AI 功能需要自行准备对应模型服务的 API Key，README 未提供具体配置命令。

核心亮点

单二进制分发，无需额外依赖，部署极简
原生集成多种 AI 模型，可直接对话生成 YAML 和排查问题
多集群管理体验流畅，切换和资源操作响应快

不足之处

项目较新，文档和社区生态尚待完善
AI 功能依赖外部 API，可能产生额外费用

适用场景

开发/测试环境快速查看多集群资源状态
运维排查故障时用 AI 辅助分析日志和事件
团队内部共享 Kubernetes 管理界面，降低 kubectl 使用门槛

替代项目

Kubernetes Dashboard、Lens、Octant

项目介绍

kubewall 是行业应用领域的开源项目，由 kubewall 开发，2024 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,937）位列前 30%，在行业应用分类的 545 个项目里位列前 14%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。Apache-2.0 许可证，可自行部署，完全免费。

它主要面向的使用场景是：开发/测试环境快速查看多集群资源状态。同类可对比的替代方案包括 Kubernetes Dashboard、Lens、Octant。

上一篇：stack-chan

下一篇：elmo