Skip to content

常见问题 (FAQ) ​

数据共享 ​

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

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

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

源代码可在 这里 找到。

权限问题 ​

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

txt
用户 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"错误:

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

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

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

yaml
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 中更改字体

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 上提交问题或开始一个讨论。

Released under the Apache License.