常见问题 (FAQ)

数据共享

默认情况下，Kite 不会收集任何分析数据。

如果您希望帮助改进产品，可以将环境变量 ENABLE_ANALYTICS 设置为 true。

Kite 将使用 umami 收集极少的匿名使用数据。

源代码可在 这里 找到。

权限问题

如果在访问资源时，遇到如下错误提示，

用户 admin 没有权限在集群 in-cluster 的命名空间 kite 中执行 获取 configmaps

表示用户 admin 没有权限访问 kite 命名空间中的 configmaps 资源。

你需要参考 RBAC 配置指南 来配置用户的权限。

托管 Kubernetes 集群连接问题

如果您使用托管 Kubernetes 集群（AKS、EKS、GKE 等）并在将集群添加到 Kite 时遇到身份验证错误，这通常是因为默认的 kubeconfig 使用了需要 CLI 工具（如 kubelogin、aws 或 gcloud）的 exec 插件。

Kite 作为服务端应用运行，无法执行这些客户端身份验证工具。相反，您应该使用基于 Service Account token 的身份验证。

请参考托管 Kubernetes 集群配置指南，了解如何创建和使用 Service Account token 进行身份验证的详细说明。

SQLite 使用 hostPath 存储问题

如果您使用 SQLite 作为数据库，并在使用 hostPath 进行持久化存储时遇到"out of memory"错误：

panic: failed to connect database: unable to open database file: out of memory (14)

此问题与 Kite 使用的纯 Go SQLite 驱动有关（为避免 CGO 依赖）。该驱动在访问某些存储后端上的数据 库文件时存在限制。

解决方案：添加 SQLite 连接选项以提高与 hostPath 存储的兼容性。在 Helm values 中设置：

db:
  sqlite:
    options: "_journal_mode=WAL&_busy_timeout=5000"

这些选项启用预写日志（WAL）模式并增加忙碌超时时间，可以解决大多数 hostPath 兼容性问题。

生产环境推荐：对于需要持久化存储的生产环境部署，建议使用 MySQL 或 PostgreSQL 代替 SQLite。这些数据库更适合容器化环境和持久化存储场景。

更多详情请参见 Issue #204。

如何更改字体

Kite 默认提供三种字体：系统默认、Maple Mono 和 JetBrains Mono。

如果您想使用其他字体，则需要自己构建项目。

用 make 构建 kite，并在 ./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);
}

我如何为 Kite 做出贡献？

我们欢迎贡献！您可以：

• 在 GitHub Issues 上报告错误和功能请求
• 提交拉取请求
• 改进文档
• 分享反馈和使用案例

我在哪里可以获得帮助？

您可以通过以下方式获得支持：

• GitHub Issues 用于提交错误报告和功能请求
• Slack Community 用于提问和社区支持

---

没有找到您要找的内容？ 欢迎在 GitHub 上提交问题或开始一个讨论。