kubewall

https://github.com/kubewall/kubewall?tab=readme-ov-file#battery-install | https://github.com/kubewall/kubewall?tab=readme-ov-file#books-guide | https://github.com/kubewall/kubewall/releases | https://github.com/kubewall/kubewall

kubewall 是一款开源的单二进制文件 Kubernetes 仪表板，具备多集群管理和 AI 集成功能。

它提供了一个简单而丰富的实时界面，用于管理和监控您的集群。

:movie_camera: 简介

[!IMPORTANT] 请注意，kubewall 仍在积极开发中。

:battery: 安装

🐳 Docker

docker run -p 7080:7080 -v kubewall:/.kubewall ghcr.io/kubewall/kubewall:latest

💡 要访问本地 kind 集群，可使用 "--network host" Docker 标志。

⛵ Helm

helm install kubewall oci://ghcr.io/kubewall/charts/kubewall -n kubewall-system --create-namespace

🛡️ 通过 Helm 安装时，kubewall 运行在端口 8443，并使用自签名证书。https://github.com/kubewall/kubewall/tree/main/charts/kubewall

🍺 Homebrew

brew install --cask kubewall/tap/kubewall

🧃 Snap

sudo snap install kubewall

🐧 Arch Linux

yay -S kubewall-bin

🪟 Winget

winget install --id=kubewall.kubewall -e

📦 Scoop

scoop bucket add kubewall https://github.com/kubewall/scoop-bucket.git
scoop install kubewall

📁 二进制文件

macOS
https://github.com/kubewall/kubewall/releases/latest/download/kubewall_Darwin_all.tar.gz%EF%BC%88%E5%A4%9A%E6%9E%B6%E6%9E%84%EF%BC%89

Linux（二进制文件）

Windows（exe）

手动安装

[!TIP] 安装完成后，可通过 http://localhost:7080 访问 kubewall

如果在 Kubernetes 集群或本地服务器上运行，建议使用 HTTPS。 当不通过 HTTP/2 使用 SSE 时，存在最大打开连接数的限制。Mozilla⤴

可使用以下命令启动启用 HTTPS 的 kubewall：

> $ kubewall --certFile=/path/to/cert.pem --keyFile=/path/to/key.pem
>

:books: 指南

标志

由于 kubewall 以二进制文件运行，您可以使用以下标志。

> kubewall --help

Usage:
kubewall [flags]
kubewall [command]

Available Commands:
completion 为指定 shell 生成自动补全脚本
help        关于任何命令的帮助
version     打印 kubewall 版本

Flags:
--certFile string      证书文件的绝对路径
-h, --help               kubewall 的帮助信息
--k8s-client-burst int  节流的最大突发量（默认 200）
--k8s-client-qps int    客户端到 master 的最大 QPS（默认 100）
--keyFile string       密钥文件的绝对路径
-l, --listen string     监听的 IP 和端口（例如：127.0.0.1:7080 或 :7080）（默认 "127.0.0.1:7080"）
--no-open-browser      不打开默认浏览器

🔐 本地设置 HTTPS

您可以使用自己的证书，或通过 https://github.com/FiloSottile/mkcert%E2%A4%B4 创建新的本地受信任证书。

[!IMPORTANT] 您需要单独安装 https://github.com/FiloSottile/mkcert%E2%A4%B4%E3%80%82

1. 在计算机上安装 mkcert。
2. 在终端或命令提示符中运行以下命令：

mkcert kubewall.test localhost 127.0.0.1 ::1

3. 此命令将生成两个文件：一个证书文件和一个密钥文件（密钥文件名称以 -key.pem 结尾）。
4. 要将这些文件与 kubewall 一起使用，请使用 --certFile= 和 --keyFile= 标志。

kubewall --certFile=kubewall.test+3.pem --keyFile=kubewall.test+3-key.pem

使用 Docker 时

使用 Docker 时，您可以通过特定标志挂载卷并提供证书。

以下示例将主机的当前目录挂载到 Docker 容器内的 /.certs 目录：

docker run -p 7080:7080 \
-v kubewall:/.kubewall \
-v $(pwd):/.certs \
ghcr.io/kubewall/kubewall:latest \
--certFile=/.certs/kubewall.test+3.pem \
--keyFile=/.certs/kubewall.test+3-key.pem

🛰️ 自定义地址/端口配置

您可以使用 --listen 标志在任何 IP 和端口组合上运行 kubewall。此标志控制应用程序绑定的接口和端口。

🔓 绑定到所有接口

kubewall --listen :7080

🌐 绑定到特定网络接口

kubewall --listen 192.168.1.10:8080

在将 kubewall 暴露到已知私有子网或容器网络时非常有用。

:man_technologist: 开发者

🤝 贡献

本项目欢迎您的 PR 和 issue。例如，代码重构、添加功能、英文修正等。

如果需要帮助，可通过上述开发者部分联系我们。

感谢所有已贡献和使用本项目的人。

⚖️ 许可证

kubewall 采用 Apache License, Version 2.0 许可证。