https://mp.weixin.qq.com/s/z6BUK61EQXKOHaAR3acBvg

Docker 运行
使用预构建镜像快速启动:

docker run –rm -p 8080:8080 -v ~/.kube/config:/home/nonroot/.kube/config ghcr.io/zxh326/kite:latest
Kubernetes 部署
应用部署清单

kubectl apply -f deploy/install.yaml
端口转发访问

kubectl port-forward -n kube-system svc/kite 8080:8080
源码编译
📋 前置要求
克隆仓库


git clone https://github.com/zxh326/kite.git
cd kite
项目构建

make deps
make build
启动服务

make run

🔍 故障排查
常见问题

  1. Prometheus 指标不可用

参考 Prometheus 配置指南 配置 Prometheus 和 kube-state-metrics。

  1. OAuth 认证问题

参考 OAuth 配置指南 排查 OAuth 配置。

  1. 统计功能问题

默认情况下 Kite 不会收集任何统计信息。如需协助产品改进,可设置环境变量 ENABLE_ANALYTICS=true。Kite 将使用 umami 收集极少量匿名使用数据,源码参见 统计模块。

  1. 自定义字体

通过 make build 构建后,修改 ./ui/src/index.css 中的字体配置:


@font-face {
font-family: "Maple Mono";
font-style: normal;
font-display: swap;
font-weight: 400;
src: url(https://cdn.jsdelivr.net/fontsource/fonts/maple-mono@latest/latin-400-normal.woff2)
      format("woff2"), url(https://cdn.jsdelivr.net/fontsource/fonts/maple-mono@latest/latin-400-normal.woff)
      format("woff");
}

body {
font-family: "Maple Mono", var(--font-sans);
}

GitHub 仓库:https://github.com/zxh326/kite.git

文档更新时间: 2025-06-27 09:21   作者:admin